On Mar 23, 1:41 pm, Yahel <[email protected]> wrote:

>
> >add a comments system to the reference pages
>
> That's what they did in the PHP documentation and it is pure gold.
> Examples, implementations, work around, bug reports....Very often way
> more instructive than the actual content of the official
> documentation.


I actually find the PHP implementation suggestive of a far better
synthesis -- the piece that is missing from it is a regular review of
these comments by someone with editorial privileges that applies the
pertinent lessons into the a new revision of article being commented
on.

Documentation should be improved by user comments, not merely become a
discussion board of its many faults.  That will help keep fruitful
reading as brief as possible.

tone

-- 
You received this message because you are subscribed to the Google
Groups "Android Developers" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/android-developers?hl=en

To unsubscribe, reply using "remove me" as the subject.

Reply via email to