Doc: slight clarification of accidentals.

diff --git a/Documentation/learning/common-notation.itely b/Documentation/learning/common-notation.itely
index ac86a64286d347742af33b9d2367e4e5f3263e81..c9eb78dd1d6ef6931ce1cad1186d305d55b159c2 100644 (file)
--- a/Documentation/learning/common-notation.itely
+++ b/Documentation/learning/common-notation.itely
@@ -62,6 +62,10 @@ on one staff.
 @node Accidentals and key signatures
 @subsection Accidentals and key signatures
 
+@warning{New users are often confused by these -- please read the
+warning at the bottom of this page, especially if you are not
+familiar with music theory!}
+
 @subheading Accidentals
 
 @cindex accidentals
@@ -169,6 +173,11 @@ note with pitch B-natural.}  In the key of A-flat major, it
 b
 @end lilypond
 
+If the above seems confusing, consider this: if you were playing a
+piano, which key would you hit?  If you would press a black key,
+then you @emph{must} add @code{-is} or @code{-es} to the note
+name!
+
 Adding all alterations explicitly might require a little more
 effort when typing, but the advantage is that
 @notation{transposing} is easier, and accidentals can be printed