[Laszlo-user] [Laszlo-dev] User community comments now supported in documentation

[Max Carlson]

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