Re: new documentation

[Graham Percival]

On Wed, 28 May 2003 13:29:55 +0000
David Bobroff <address@hidden> wrote:
> I find it much easier
> to see an example of something like what I'm trying to do and see how
> it is done and then make use of the method.

I learn the same way.  There are many examples in the input/ directory
(in the web docs, look at the "tips n' tricks" and "regression test"
links), or else read Mutopia.

> where to look I would not have found it.  That is what a good index
> does, it tells you where to look.  It would have been very intuitive
> to see and index entry something like:

In the index,
http://lilypond.org/development/Documentation/user/out-www/lilypond/Index.html
it's true that we have "MultimeasureRest" without a pointer to that spot
under "Rests", although the page on Rests has a link to Multimeasure
rests... would the index be much better if we had a "rest, multimeasure" entry
as well?


You mentioned that you're a novice user... want to help write the docs? 
When I was a novice (I'm being optimistic in using the past tense here!
:), I thought that novices were the best people to be writing docs,
since everything isn't obvious to us.  I still think that novices are
good for writing docs, BTW.  Want to help?
Don't be concerned about the way the docs are written; it's not hard to
learn how to modify them.  If you're interested, feel free to ask me any
questions about how the docs are organized, how to write texinfo, how to
make a patch, etc.  I often "adopt" Linux newbies, so don't be scared to
ask me any question, no matter how silly is seems.
We need more people working on the docs; in part to spread the workload around,
but also because having more points of view helps a lot for docs.

Cheers,
- Graham