From: Urs Liska <git@ursliska.de>
Date: Tue, 7 Jan 2014 11:51:02 +0000 (+0100)
Subject: Issue 3785:Web:Background: Reword intr. paragraph
X-Git-Tag: release/2.19.1-1~20^2~3
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=52a5d6c1a6bd722b9f04950b2d9ba6cc7f25d546;p=lilypond.git

Issue 3785:Web:Background: Reword intr. paragraph

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.
---

diff --git a/Documentation/web/introduction.itexi b/Documentation/web/introduction.itexi
index 189d5676c2..af0c9f7101 100644
--- a/Documentation/web/introduction.itexi
+++ b/Documentation/web/introduction.itexi
@@ -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}