Re: Just shoot me now (was Re: What's wrong with this fancy split?)

[asjo@koldfront.dk (Adam Sjøgren)]

On Wed, 22 Dec 2010 06:53:07 -0600, Tommy wrote:

> So where does that leave us? 

It is much easier for a developer deep in the code to receive a
documentation patch, look at it, and say "Ok, that sounds fine,
applied", than it is to receieve a suggestion in words that something -
while technically correct - is slightly confusing to a (new) user.

(E.g. I agree that not escaping '.' in a regexp matching a domain is
confusing to a user who is trying to check his "world-view" by looking
at the examples, but it is also plain to see that it isn't wrong - and a
user thinking 'regular expressions' will recognize that (but then the
clue of "flawless" examples go down the drain)).

What I am trying to say is that I think you will find much less argument
if you dig out git and start supplying your suggestions for improvements
as patches to the manual.

It is quite natural to say "Meh, but it isn't wrong" if you're asking
someone to do... the horror... work!

Appreciating this type of feedback isn't always easy to do cheerfully,
sometimes it will be curmudgeonly.

> Either the user is thick, or the documentation is thick.

Or the user is trying to achieve to many things at once. There is a
learning curve, even if you aren't thick ;-)


  Best regards,

    Adam

-- 
 "Accept the mystery!"                                        Adam Sjøgren
                                                         asjo@koldfront.dk