lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

proposal for doc rearrangement


From: Graham Percival
Subject: proposal for doc rearrangement
Date: Sat, 11 Jul 2009 03:14:45 -0700
User-agent: Mutt/1.5.18 (2008-05-17)

Here's my proposal for doc rearrangement from a doc writer's
perspective.
( - minus, + plus )

LM
- background essay
- about the docs    (nobody reads it there, anyway)
+ expand 2.1.1 Compiling a file into:
   + LM 1.1 Compiling with LilyPond and LilyPad
   + LM 1.2 Alternate editors
- (possibly) Working on LilyPond Projects

Essay
+ background essay
+ essay from website.  (maybe merged, maybe separate)
+ literature list
+ anything else scholarly

NR
- literature list

AU
- install, compile.  (that'll be in the CG and available as
  INSTALL.txt in source)
- setup  (separating into website and LM 1.2)
+ (possibly) Working on LilyPond Projects
+- rewrite lots
+ (possibly) guides ("how to use lilypond to X"), maybe
  algorithmic music, etc.  There's always been some interest in
  this, and it doesn't fit in to the LM or NR.


I think the only iffy proposal here is moving LM 5 Working on
LilyPond Projects.  It's partly because I can't find it in me to
blame newbies[1] who don't notice LM 5 and ask stupid questions
later, and partly just to beef up the AU so people don't
completely ignore it.  I'm not completely certain about that
change, so opinions are welcome[2].

[1] this is always my primary concern when organizing the docs.

[2] although I feel quite good about all the other changes,
opinions are still welcome.  In the words of one of my
supervisors, "feel free to disagree with me.  You'll be wrong, but
feel free to disagree!"

Cheers,
- Graham





reply via email to

[Prev in Thread] Current Thread [Next in Thread]