Henry, This is great! A few things:
1) I'm concerned about having the commenting system come from beartronics.com. When can we get it moved over to an OL domain?
2) It would be great if the form appeared inline on the page so the documentation is still available for reading, copy/paste, etc. How about showing a <div> when you click the 'add a comment link'?
3) It's just a matter of time before spammers figure out the answer to the anti-spam question. We really need a captcha or something - this is an arms race for sure...
Henry Minsky wrote:
There is now a way for developers to add comments and examples to the documentation. At the bottom of every doc page is a link that lets you write a comment or tip. The comments will be sent to volunteer reviewers, and if approved will appear on the doc page. The guideline for comments is similar to the PHP docs; you should add tips or code samples that clarify the documentation on that page. Questions and bug reports should be filed in JIRA or posted to the mailing lists or forums. You can see the doc-with-comments feature on the docs on the nightly build only for now, for example the reference manual http://labs.openlaszlo.org/trunk-nightly/docs/reference/ The comment-enabled docs are in trunk, so they will appear on the openlaszlo.org docs with the next release. Please try contributing some comments with the nightly build, so we can debug the comments system. Also send me a note if you want to be a volunteer reviewer.
-- Regards, Max Carlson OpenLaszlo.org
