Urs Liska <u...@openlilylib.org> writes:
> Would somebody please be so kind and push the attached patch?
> From: Urs Liska <g...@ursliska.de>
> Date: Mon, 27 Jan 2014 11:48:24 +0100
> Subject: [PATCH] Issue 3804:Web:Text-input: make LM reff more friendly
Pushed to staging as
commit 73346163907e09dd0c1e7d6956770379f8bc3971
Author: Urs Liska <g...@ursliska.de>
Date: Mon Jan 27 11:48:24 2014 +0100
Issue 3804:Web:Text-input: make LM reff more friendly
> -Please read the Learning Manual before complaining about bugs!
> -New users occasionally believe that LilyPond is not working
> -correctly, when in fact it is working precisely as designed.
> +Occasionally new users are unnecessarily confused by some aspects
> +of LilyPond's behaviour. Please read this manual before doubting
> +whether LilyPond is working correctly.
>
> More in-depth information is available in @ref{Manuals}.
I'm really bad at timely review, but it might make sense to rethink some
of the wording in a future version.
"unnecessarily" seems unnecessary to me here as it implies the existence
of "necessary confusion" and/or some deficiency in some new users. Also
"doubting" implies questions of belief.
Of course, this sort of "bikeshedding" over the wording can take
arbitrary amounts of time and discussion without any significant
improvement. I'm just throwing out another suggestion that might be a
bit more careful about avoiding condescension:
Some of LilyPond's design decisions are not self-evident but may
require a larger context to understand. A number of restrictions
are a consequence of the current design and/or implementation and
are both well-known and documented. For that reason, it is
recommended to work at least through the Learning Manual before
reporting issues.
All the best
--
David Kastrup
_______________________________________________
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel
