Re: Fwd: Re: Issue 3804 in lilypond: Patch: Web: Text-input: make LM reference more friendly.

[David Kastrup]

Urs Liska <address@hidden> writes:

> Would somebody please be so kind and push the attached patch?

> From: Urs Liska <address@hidden>
> 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 <address@hidden>
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