Re: Documentation Review
Valentin, you wrote Saturday, September 27, 2008 7:41 PM I'm sure there's plenty of room for improvements, but could we add NR 1.8 "Text" to the list of sections to be reviewed? Corrections, suggestions and criticism are welcome! Done! This is a major piece of work! We now need reviewers for this and several other sections. Cheers, Valentin Trevor ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
2008/9/22 Trevor Daniels <[EMAIL PROTECTED]>: > Several sections of the Learning Manual and most of the first > two Chapters of the Notation Reference are ready for review by users, and it > would be good to bring these to the best possible state before 2.12 is > released. Greetings Trevor, I'm sure there's plenty of room for improvements, but could we add NR 1.8 "Text" to the list of sections to be reviewed? Corrections, suggestions and criticism are welcome! Cheers, Valentin ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Searching the docs (was: Re: Documentation Review)
Am Wed, 24 Sep 2008 11:05:59 +0200 schrieb Sebastian Menge <[EMAIL PROTECTED]>: > http://www.google.com/search?hl=en&q=site%3Alilypond.org+inurl%3Av2.11+blah Another refinement: Add "intitle:Manual" or "intitle:Reference" to search only the manual or the reference. More here: http://www.google.com/help/operators.html Firefox users can add these searches easily as a Keyword Search Engine.: "lm blah" instead of the URL would search http://www.google.com/search?q=site:lilypond.org+intitle:Manual+inurl:v2.11+blah To configure that, just make a bookmark, replace the search-term by "%s" and add a keyword like "lm". Then " lm something" is _very_ quick to search the manual for "something" ... Seb. PS: the same holds for amazon, news, wikis etc... A quite powerful feature IMHO. ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
Am Wed, 24 Sep 2008 10:14:00 +0200 schrieb Jan Nieuwenhuizen <[EMAIL PROTECTED]>: > On di, 2008-09-23 at 23:16 +0200, Valentin Villenave wrote: > > 2008/9/23 Mats Bengtsson <[EMAIL PROTECTED]>: > > > > > We have one on the main page of lilypond.org, but unfortunately > > > it often finds hits in old versions of the documentation first. > > > > Hadn't we solved this problem by adding an appropriate robots.txt? > > http://lists.gnu.org/archive/html/lilypond-devel/2008-05/msg00169.html > > As this mail says: possibly not. So: apparently not. > > What if we add a version marker to each page, and automagically also > add +v2.x.y to the search box? Would this suffice? http://www.google.com/search?hl=en&q=site%3Alilypond.org+inurl%3Av2.11+blah And the search box should be more prominent, I have two scroll twice before I find it. Suggested Reading: Jakob Nielsen, "Designing Web Usability: The Practice of Simplicity" Old, but worth reading. Seb. ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
On di, 2008-09-23 at 23:16 +0200, Valentin Villenave wrote: > 2008/9/23 Mats Bengtsson <[EMAIL PROTECTED]>: > > > We have one on the main page of lilypond.org, but unfortunately > > it often finds hits in old versions of the documentation first. > > Hadn't we solved this problem by adding an appropriate robots.txt? > http://lists.gnu.org/archive/html/lilypond-devel/2008-05/msg00169.html As this mail says: possibly not. So: apparently not. What if we add a version marker to each page, and automagically also add +v2.x.y to the search box? Jan. -- Jan Nieuwenhuizen <[EMAIL PROTECTED]> | GNU LilyPond - The music typesetter http://www.xs4all.nl/~jantien | http://www.lilypond.org ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
2008/9/23 Mats Bengtsson <[EMAIL PROTECTED]>: > We have one on the main page of lilypond.org, but unfortunately > it often finds hits in old versions of the documentation first. Hadn't we solved this problem by adding an appropriate robots.txt? http://lists.gnu.org/archive/html/lilypond-devel/2008-05/msg00169.html Cheers, Valentin ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
Trevor Daniels wrote: Sebastian Menge wrote Monday, September 22, 2008 9:54 PM I would suggest: * a search engine field at the top of the main template (cf wikipedia) It would be nice, and others are pressing for this, but it poses some problems. We have one on the main page of lilypond.org, but unfortunately it often finds hits in old versions of the documentation first. /Mats ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
Sebastian Menge wrote Monday, September 22, 2008 9:54 PM I would suggest: * a search engine field at the top of the main template (cf wikipedia) It would be nice, and others are pressing for this, but it poses some problems. * way more hyperlinks: especially between corresponding parts of tutorial <-> manual <-> reference. I agree. This is something we shall look at when the basic text is satisfactory. (Links can't be added reliably until the text has stabilised.) And one thing concerning the section I just learned: "For every \skip, the text will be delayed another note. " Is it a note or a syllable? What does the param mean? I'll clarify this. The param has to be a valid duration and present, but it is ignored in lyrics. Before getting to destructive: I love lilypond! Big thanks to all contributors. Thanks :) Regards, Seb. Trevor ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
Perhaps a bit off topic: Im using lilypond only once a year or so. Then every time I have to read a lot of the docs again. Since i remember most things then, i'm quite quick (getting quicker every time ;-) ), but I must admit that I dont find my way through the docs as quickly as I could: I would suggest: * a search engine field at the top of the main template (cf wikipedia) * way more hyperlinks: especially between corresponding parts of tutorial <-> manual <-> reference. And one thing concerning the section I just learned: "For every \skip, the text will be delayed another note. " Is it a note or a syllable? What does the param mean? Before getting to destructive: I love lilypond! Big thanks to all contributors. Regards, Seb. Am Mon, 22 Sep 2008 18:02:44 +0100 schrieb "Trevor Daniels" <[EMAIL PROTECTED]>: > > Help needed to review documentation before 2.12 is released. > --- > > Several sections of the Learning Manual and most of the first > two Chapters of the Notation Reference are ready for review > by users, and it would be good to bring these to the best > possible state before 2.12 is released. To do this we need > -your- help. All you need to do is browse through any of the > sections mentioned below and post any comments you may have > to the -user list. Some of these sections have been reviewed > earlier, but further comments are welcome. > > The most up-to-date development documentation can be found at: > > http://kainhofer.com/~lilypond/Documentation/ > > These sections are ready for review: > > Learning Manual: > 1 Introduction > 2 Tutorial > 3 Fundamental concepts > 4 Tweaking output > > Notation Reference: > 1.1 Pitches > 1.3 Expressive marks > 1.4 Repeats > 1.5 Simultaneous notes > 1.6 Staff notation > 1.7 Editorial annotations > > 2.2 Keyboard instruments > 2.4 Fretted string instruments > 2.5 Percussion > 2.7 Chord notation > > Many thanks for your help > > Trevor > > > > > > ___ > lilypond-user mailing list > lilypond-user@gnu.org > http://lists.gnu.org/mailman/listinfo/lilypond-user -- __ Dipl.-Inform. Sebastian Menge Lehrstuhl Software-Technologie TU Dortmund, FB Informatik Tel: 0231-755 4895 Fax: 0231-755 2061 Email: [EMAIL PROTECTED] Web: http://ls10-www.cs.uni-dortmund.de/~menge __ ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
A rousing hip, hip, hurrah to the authors of the documentation. Few (if any) commercial products can boast of similar quality! Regards, Stan On Sep 22, 2008, at 1:58 PM, Jonathan Kulp wrote: Well spotted! I should have seen it from the fact that it's impossible to play this way, if not from the facsimile itself (which I just checked, too). Thanks, Stan. I'll fix and send to Carl. Jonathan Stan Sanderson wrote: On Sep 22, 2008, at 12:02 PM, Trevor Daniels wrote: but further comments are welcome. Re: sect. 2.4 The motivating example is beautifully set, but has an incorrect fingering in the second measure. The next to the last eighth note (e above middle c) should be fingered with the first finger (i.e., a barre). I checked with the original and Mertz (the composer) agrees! I will keep looking... Stan ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user -- Jonathan Kulp http://www.jonathankulp.com ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
Well spotted! I should have seen it from the fact that it's impossible to play this way, if not from the facsimile itself (which I just checked, too). Thanks, Stan. I'll fix and send to Carl. Jonathan Stan Sanderson wrote: On Sep 22, 2008, at 12:02 PM, Trevor Daniels wrote: but further comments are welcome. Re: sect. 2.4 The motivating example is beautifully set, but has an incorrect fingering in the second measure. The next to the last eighth note (e above middle c) should be fingered with the first finger (i.e., a barre). I checked with the original and Mertz (the composer) agrees! I will keep looking... Stan ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user -- Jonathan Kulp http://www.jonathankulp.com ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Re: Documentation Review
On Sep 22, 2008, at 12:02 PM, Trevor Daniels wrote: but further comments are welcome. Re: sect. 2.4 The motivating example is beautifully set, but has an incorrect fingering in the second measure. The next to the last eighth note (e above middle c) should be fingered with the first finger (i.e., a barre). I checked with the original and Mertz (the composer) agrees! I will keep looking... Stan ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
Documentation Review
Help needed to review documentation before 2.12 is released. --- Several sections of the Learning Manual and most of the first two Chapters of the Notation Reference are ready for review by users, and it would be good to bring these to the best possible state before 2.12 is released. To do this we need -your- help. All you need to do is browse through any of the sections mentioned below and post any comments you may have to the -user list. Some of these sections have been reviewed earlier, but further comments are welcome. The most up-to-date development documentation can be found at: http://kainhofer.com/~lilypond/Documentation/ These sections are ready for review: Learning Manual: 1 Introduction 2 Tutorial 3 Fundamental concepts 4 Tweaking output Notation Reference: 1.1 Pitches 1.3 Expressive marks 1.4 Repeats 1.5 Simultaneous notes 1.6 Staff notation 1.7 Editorial annotations 2.2 Keyboard instruments 2.4 Fretted string instruments 2.5 Percussion 2.7 Chord notation Many thanks for your help Trevor ___ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user