Data.List documentation improvements

Donald Bruce Stewart dons at cse.unsw.edu.au
Fri Dec 8 01:41:59 EST 2006


duncan.coutts:
> On Thu, 2006-12-07 at 09:49 -0800, Iavor Diatchki wrote:
> > Hi,
> > instead of adding examples to the documentation, wouldn't it be better
> > to have a wiki site that documents the libraries, and everyone can add
> > examples there.  I am thinking something along the lines of:
> > http://us2.php.net/manual/en/function.fopen.php
> 
> I added a feature to Haddock to link modules/functions to source code
> and/or to a wiki site (the feature is included in haddock 0.8). So we
> could make something like this work for the standard set of docs on the
> ghc site.
> 
> We'd need to decide on a url scheme and probably find some way of using
> a standard template or pre-creating the wiki pages (I'd assume we'd have
> one per module). It's possible to link on a per-function basis to
> content inside a wiki page if you use a url scheme like:
> 
> http://haskell.org/haskellwiki/libraries/%module%#%varid%
> 
> I assume it's possible to make href anchors in a wiki page, though to do
> it consistently might need more advice from the wiki experts.

Yes, this is a great idea. a [wiki] or some such link for haddock docs
in standard libraries taking us to pages to be filled out with examples
and recipes.

-- Don


More information about the Libraries mailing list