[Haskell-cafe] expanded standard lib

Bayley, Alistair Alistair_Bayley at invescoperpetual.co.uk
Tue Nov 20 04:51:01 EST 2007


> | > 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.
*****************************************************************


More information about the Haskell-Cafe mailing list