Re: GDP: the snippets vs. texinfo

[Hans Aberg]

On 10 Nov 2007, at 06:02, Graham Percival wrote:

> PDF vs. HTML: pdf readers generally prefer to have consecutive  
> documentation, with few links.  HTML readers generally prefer to  
> have links everywhere.

Those that produce both seem to choose a format that can produce both  
automatically by some program. For example the texinfo format. But  
that might unsuitable for LilyPond. So you might need you own format.

> Stable docs vs. wiki: some people want an unchanging, complete,  
> finished set of docs, particularly if they print them out.  Other  
> people like the constant flux of web 2.0 stuff.

These do different things. The docs should be designed to lower the  
need ask questions on the lists, I think.

A wiki can in fact be used to replace the LilyPond site altogether.  
One example is
  http://haskell.org/
which nowadays expand to
  http://haskell.org/haskellwiki/Haskell
So it is possibly the whole Haskell site. Once upon the time, the  
Haskell wiki was a separate project.

  Hans Åberg