]> git.donarmstrong.com Git - lilypond.git/commitdiff
Issue 3785:Web:Background: Reword intr. paragraph
authorUrs Liska <git@ursliska.de>
Tue, 7 Jan 2014 11:51:02 +0000 (12:51 +0100)
committerDavid Kastrup <dak@gnu.org>
Sun, 12 Jan 2014 09:41:41 +0000 (10:41 +0100)
I've always found this page confusing because I didn't understand
why there is this "placeholder" page.
This commit addresses this by making the "manual" issue explicit.

Additionally I consider it more useful to _first_ tell the reader
what it is and _then_ advise him to skip the essay instead of
_immediately_ telling him "Probably you won't want to read this".
If it is necessary to have the link at the end of a paragraph
(and not only of a sentence) I'd simply insert a new paragraph
after the link.

Documentation/web/introduction.itexi

index 189d5676c214539ebec7a8d2b087801a130f77cf..af0c9f7101a408ac344dc1ec17ad665c9cef2032 100644 (file)
@@ -556,9 +556,11 @@ LilyPond, first read about our @ref{Text input}.
 We have an extensive essay describing computational aesthetics:
 the art of creating beauty with a computer.
 
-If you just want a quick introduction to LilyPond, the essay might
-be too much material to read.  If you would like to read it now,
-please progress to @ref{Essay}.
+This is interesting reading if you are interested in an in-depth
+discussion of our fundamental ideas.  Due to its volume the
+essay is available as a "manual".  If you would like to read
+it now, please progress to @ref{Essay}.  However, if you just
+want a quick introduction to LilyPond, you might skip it for now.
 @divEnd
 
 @divClass{column-center-bottom}