From ecd405a631a30b242e08969880f9cead4ea201bc Mon Sep 17 00:00:00 2001 From: Jan Nieuwenhuizen Date: Wed, 11 Feb 2004 09:58:11 +0000 Subject: [PATCH] Fix outline mode. Add book notes. --- ChangeLog | 2 + TODO | 159 +++++++++++++++++++++++++++++++++++++++++++++++------- 2 files changed, 142 insertions(+), 19 deletions(-) diff --git a/ChangeLog b/ChangeLog index 5dd0004399..c04e4e79e3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,7 @@ 2004-02-11 Jan Nieuwenhuizen + * TODO: Fix outline mode. Add book notes. + * ROADMAP: Update. 2004-02-11 Han-Wen Nienhuys diff --git a/TODO b/TODO index b3ff87fb8e..684f4e8f65 100644 --- a/TODO +++ b/TODO @@ -3,41 +3,43 @@ This file is our personal scrapbook, listing what we want to do in the nearby future -***************** Website +* Website -* mission.html +** mission.html -* benchmark Schubert +** benchmark Schubert -***************** Bugs +* Bugs -* pc-solo.ly +** pc-solo.ly -* staff-padding / padding. +** staff-padding / padding. -***************** Code +* Code -* \set / \override syntax +** \set / \override syntax -* lyricsvoice -> lyrics. +** lyricsvoice -> lyrics. -***************** Documentation -* Prune internals documentation. +* Documentation -* Move Markup doc to docstrings. +** Prune internals documentation. -* Sift examples, move into main doc. +** Move Markup doc to docstrings. -***************** Release 2.2/3.0 +** Sift examples, move into main doc. -* upload -* binaries +* Release 2.2/3.0 -* announce +** upload + +** binaries + +** announce News: @@ -45,8 +47,127 @@ nearby future Web: -* translation project. +** translation project. + +** mutopia submissions + + +* Book + +** Status and planning + +[L] The book still needs a lot of work, but it is not insurmountable. +The pieces are there; they need to be re-ordered and integrated +better. + +[L] There are still some rough patches - whole pages - that still need +real work. The general polished sections still have a large number of +English errors. Some errors collected together; whole sentences need +to be completely rewritten. + +[L] This will take an active partnership between the editing staff and +one or more authors. It will take 2 months or more of a lot of time +(~15hrs a week) on the part of the LilyPond maintainers, and then +another couple of months of occasional follow-up emails as we do the +fine-tooth comb English edits and get it ready for press. + + +** Manual structure, fitting pieces together + +*** [L] SKIP: Regression Tests for Developers -- input/regression + +*** Templates -- input/templates/out-www/collated-files.tely +[L] Appendix to the printed manual. + +*** Glossary -- Documentation/user/music-glossary.tely +[L] Appendix to the printed manual. + +Get authors and license. + +*** Examples -- input/examples + +[L] These (or some of these) need to be integrated into the book. To +save space, each example should show just one page of music. + +[L] The best way is to add an illustrative example as it's own sub-section +within the tutorial, after a section discussing a certain technique, +music issue, or typesetting problem. For instance, after a discussion +of how to do multi-voice notation, put a half page or one page choral +piece. + +[L] I think this extra time is well worth it. It will add a *lot* of +value to the book relative to the amount of work being done. (A much +better value/time ratio than the countless necesary-evil hours we +spend doing "fine-tooth comb" English editing.) + +[L] Before you spend any time on it, you should post a request to your +mailing list. + + +*** Compile -- Documentation/topdocs/INSTALL.texi + +[L] Normally, all our technical manuals include a section on How to +Install. Too terse and UNIX (problems) only. + +UNDECIDED: Possibly get info from newweb/site/download/, + +*** Program Reference -- Documentation/user/out-www/lilypond-internals + +[L] Big problem. + +[L] I leave it up to you to decide which cross +references really must be included and then add the information to the +main text. Any reference to internal commands that aren't included in +the main text should be cut from the printed version. We can make a +note in the book that says "for complete information on every single +internal command, see http://www....." + +Either add to manual in condensed form (we'll try that first), or +remove all x-references. + +*** Tips and Tricks -- input/test/out-www/collated-files.tely + +[L] I worry that important updates and helpful advice are lost in +here, instead of integrated into the manuscript. + +[L] It sounds like a lot of the material is already completed. Can you +convert the Templates file into a Texinfo-formatted appendix? + +Ask users. + + +*** SKIP: why switch? -- newweb/site/switch/advantages.html +*** SKIP: feature list -- newweb/site/about/features.html + +[L] Useful source material for me when writing back-cover text, a sales +sheet or ad, but not needing integration into the manual itself. + +*** SKIP: crash course -- newweb/site/switch/howto.html + +[L] Some part of this might be useful as back-cover text, to help quickly +explain things while someone is standing in a bookstore, thinking +about it. However, it does not need to be integrated into the +manual. + +*** SKIP: faq -- newweb/site/about/faq.html + +*** SKIP: essay -- newweb/site/about/automated-engraving/ + +[L] The majority of the info in this essay has already been added to +the manual. + +** Issues + +*** INSTALL.texi -- CD + +[L] After reading your notes about the compilation problems, I am even +more committed to doing it as a book&CD. -* mutopia submissions +UNDECIDED: [L] I am not going to bother creating a ready-to-run live-CD. +*** Graphical interfaces + * NoteEdit + * RoseGarden + [* Denemo] + -- 2.39.5