[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Possible documentation error in 2.7.2
From: |
Carl Sorensen |
Subject: |
Re: Possible documentation error in 2.7.2 |
Date: |
Sat, 29 Feb 2020 19:39:11 +0000 |
User-agent: |
Microsoft-MacOutlook/10.10.13.200210 |
On 2/29/20, 1:46 AM, "Ben Eichler" <address@hidden> wrote:
HI there,
I read at "2.7.2 Displaying Chords" in the docs: "*Chord names can be
displayed only at the start of lines and when the chord changes.*"
This is a little bit misleading. By default, each chord in the content is
printed by Lilypond. The documentation is trying to point out that this
behaviour can be overridden, but this is not apparent to new readers of the
documentation.
Could this sentence in the documentation be clarified to something like
this: *"By default, each chord in the content is printed. This behaviour
can be overridden using the chordChanges setting, as shown below."*
The original sentence is in a selected snippet. ALL of the selected snippets
are used to show overrides, because we try to avoid overrides in the main body
of the text.
The second sentence of your proposal goes against the documentation policy. We
don't talk through the code. We consciously and deliberately make these
descriptions as short as possible.
Something like "The ChordNames context can be set to display chord names only
at the start of lines and when the chord changes." would be more consistent
with our policy, although listing the context name is suspect. How would you
feel about that sentence?
Thanks,
Carl