Re: Documentation Review

2008-09-27 Thread Valentin Villenave
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


Re: Documentation Review

2008-09-27 Thread Trevor Daniels


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-09-24 Thread Jan Nieuwenhuizen
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-09-24 Thread Sebastian Menge
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=enq=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


Searching the docs (was: Re: Documentation Review)

2008-09-24 Thread Sebastian Menge
Am Wed, 24 Sep 2008 11:05:59 +0200
schrieb Sebastian Menge [EMAIL PROTECTED]:

 http://www.google.com/search?hl=enq=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 Ctrl-T 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

2008-09-23 Thread Mats Bengtsson

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

2008-09-23 Thread Valentin Villenave
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

2008-09-22 Thread Stan Sanderson


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


Re: Documentation Review

2008-09-22 Thread Stan Sanderson
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

2008-09-22 Thread Trevor Daniels


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