Another thought on documentation: many large projects, such as PHP,
allow users to add comments on the end of each manual page or section.
See this page, for example:
http://us2.php.net/manual/en/function.fopen.php

        This is tremendously helpful because users can elaborate on the
documentation and add feedback, comments, and caveats, which can then be
incorporated in future versions of the documentation.  And a person
wouldn't have to reference multiple sources (ie, the wiki errata page
and the actual manual pages) to find their answer.

-- 
Patrick Walsh
eSoft Incorporated
303.444.1600 x3350
http://www.esoft.com/

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to