On 12-Jan-05, at 2:27 AM, Ferenc Wagner wrote:
Please see the thread of emails in the mailing list archive, starting at http://lists.gnu.org/archive/html/lilypond-user/2005-01/msg00095.html
Now, it looks like everybody has the *exact* same problem. So let's change the documentation.
Absolutely.
These emails are being kept in my "potentially add to docs" section. Of course, so are 83 other emails. Most of them are just discussion about an issue (and can thus be dropped once I understand the discussion), but not all of them.
How can we improve the manual faster? Be very specific about the changes. For example,
For a start we could insert a warning into the tutorial section "Single staff polyphony" that it messes up \addlyrics, see here and there.
This is a good start, but I still need to read the tutorial, read this discussion, and (in the case of lyrics) learn how lyrics work -- I never use lyrics, so I'm not the best person to write documentation for their use.
If you (or anybody) could write material and tell me exactly where to put it, I could update the docs much faster. You don't need to download CVS, edit texinfo, or anything like that.
For example, you could say this:
----
http://lilypond.org/doc/v2.4/Documentation/user/out-www/lilypond/ Printing-lyrics.html
In section 2.13 (printing lyrics), above the last line ("More options, like..."),
please add:
To add lyrics to a divided part, use foo bar. For example,
\score {
\notes {blah <<blah>> }
\lyrics {blah <<blah>> }
blah blah blah
}
------If I have something like that, I can easily see where it goes, check if it belongs
there, check the spelling and grammar, and put the lilypond code into
the texinfo document. I might not agree with where you wanted to put it,
so I might add it to a different section (with a link from the place you wanted
it). For example, I think that divisi lyrics are too complicated to go in
section 2.13; I'd probably add them to chapter 5. But if I have some
material to work with, I can deal with it much faster.
This goes for all the other "why don't you document this" or "the docs should
say something about this" issues. Tell me exactly what you want and where.
You don't need to compile anything, you don't need to download the source
tree, or anything like that. All you need are the documentation, an email
client, and a bit of time.
Cheers, - Graham Percival, Documentation Editor.
_______________________________________________ lilypond-user mailing list [email protected] http://lists.gnu.org/mailman/listinfo/lilypond-user
