Re: doc reorg (especially Usage) possibly finished

[Carl Sorensen]

On 9/27/09 11:55 AM, "John Mandereau" <address@hidden> wrote:

> Le dimanche 27 septembre 2009 à 17:37 +0100, Graham Percival a écrit :
>> How much of scheme do we get into, though?  I mean, what about
>> moving it back into Notation?
> 
> This would be wrong: even if we expanded it up to make a big chapter, it
> would not become reference documentation (we alreadhy have Notation Ref.
> 6 "Interfaces for programmers" and the Internals Reference for this), it
> would remain learning material.
> 
> 
>> As far as I'm concerned, as long as newbies know that it's
>> *possible* to do all sorts of funky stuff with this magical scheme
>> stuff, that's all they need to know.  I mean, nobody can seriously
>> complain that we're newbie-unfriendly by not explaining how to
>> make noteheads automatically change size based on their staff
>> position!
> 
> Certainly.  However, when we decide time has come to significantly
> expand this appendix and it gets too big to remain an appendix, we'll
> have to reword the reading guidelines so the reader doesn't feel he
> should even read this chapter, e.g. by recommending that "all this
> manual should be read from cover to cover, except the last chapter
> "Scheme tutorial", that can be read later to make better use of Chapters
> 5 and 6 of the Notation Reference, for example."


I think that my preference would actually to create a LilyPond Programming
manual, with the Scheme Tutorial and a rewritten NR6.  I don't think that
NR6 is actually Notation Reference.  That particular chapter has seemed to
me to be out of place anyway.

Thanks,

Carl