| > the php documentation has "user contributed notes" | > http://www.php.net/manual/en/introduction.php | > I think this is a very nice feature.
* Hardest of all: evolution. Both GHC's user manual and library docs change every release. Even material that doesn't change can get moved (e.g. section reorganisation). We don't want to simply discard all user notes!
Just for comparison: PostgreSQL's site has a similar feature (http://www.postgresql.org/docs/manuals/). However, they don't appear to migrate user notes between documentation versions e.g. these pages from 8.1 have comments: http://www.postgresql.org/docs/8.1/interactive/rules.html http://www.postgresql.org/docs/8.1/interactive/user-manag.html the equivalent pages from 8.0 have no/different comments: http://www.postgresql.org/docs/8.0/interactive/rules.html http://www.postgresql.org/docs/8.0/interactive/user-manag.html So that could be a starting point, but it does seem a bit unsatisfactory. Alistair ***************************************************************** Confidentiality Note: The information contained in this message, and any attachments, may contain confidential and/or privileged material. It is intended solely for the person(s) or entity to which it is addressed. Any review, retransmission, dissemination, or taking of any action in reliance upon this information by persons or entities other than the intended recipient(s) is prohibited. If you received this in error, please contact the sender and delete the material from any computer. *****************************************************************