lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Web:Background: Reword introductory paragraph (issue 48360044)


From: lilyliska
Subject: Web:Background: Reword introductory paragraph (issue 48360044)
Date: Tue, 07 Jan 2014 11:55:39 +0000

Reviewers: ,

Description:
Web:Background: Reword introductory 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.

Please review this at https://codereview.appspot.com/48360044/

Affected files (+5, -3 lines):
  M Documentation/web/introduction.itexi


Index: Documentation/web/introduction.itexi
diff --git a/Documentation/web/introduction.itexi b/Documentation/web/introduction.itexi index 5d2f8c629d039c7d04a02404a8c0773d89fb65fc..0a5e2d482f2e362f2f462ba1daeb4a7a7467c9f3 100644
--- a/Documentation/web/introduction.itexi
+++ b/Documentation/web/introduction.itexi
@@ -551,9 +551,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}





reply via email to

[Prev in Thread] Current Thread [Next in Thread]