Another improvement suggestion for the doc system: Somehow verify email addresses, either the standard 'type twice' or something...

And, we still plan on making it so I can tell why I rejected a comment using a web form?

Maybe we should allow rejected comments to display for some length of time, with the rejection reason?

Begin forwarded message:

From: P T Withington <[email protected]>
Date: 13 April 2009 15:24:15.000 EDT
To: [email protected]
Subject: Re: OpenLaszlo doc comment for review: 1239648953

[Guess we should also make people type their email twice. I bet your email address is not 'gamil.com'.]

Thanks for your comment, but I have to reject it because it is in fact a bug. Please file a bug at jira.openlaszlo.org.

Author: Suzie
Email: [email protected]

Is the following statement from above in Section 6.1 correct, or was it a victim of search and replace over zealousness?

"In earlier versions of LZX (before OpenLaszlo 4), there was an asymmetric mapping between tag and class names, often of the form LzFoo <—> <foo>, as in the correspondence between, say the class name lz.view and the tag name <view>. (Notice in lz.view the mixed case, and the absence of the period between lz and the tag name.) Also there was a distinction between LFC classes and user-created classes. The new lz.foo form is consistent across LFC classes ...."


Should the parenthetical statement read:

"(Notice in lzView the mixed case, and the absence of the period between lz and the tag name.)"

Personally, I think this is far more detail than is needed. Why document the old system, which was simply confusing. The new system is straight-forward. If there is a tag named <foo>, the class that implements it is named `lz.foo`, for all tags.


Reply via email to