Daniel

I am with you on this. Saying no is not easy, because sometimes offends the
person whose contribution is being removed. Most understand that it is a
judgement call on their contribution no on their person, but some do not
understand that and can even turn to flaming. Only thing to do is to done a
padded asbestos suit, and keep prodding :-)

In the end, the product (the best manual for a programming language, bar
none) speaks for itself.

Cheers (from an old fart who pokes his head to blurt nonsense once in a
while).

--
Jesus M. Castagnetto <je...@castagnetto.com>
Web: http://www.castagnetto.com/


On Tue, Mar 13, 2012 at 10:34, Daniel Brown <danbr...@php.net> wrote:

> On Fri, Feb 24, 2012 at 16:54, Maciek Sokolewicz
> <maciek.sokolew...@gmail.com> wrote:
> > A few days ago I deleted a note, and the author sent a mail to the
> > php-general list complaining about it. The answer by Dan was basically
> that
> > the notes maintainers are overzealous and the author should contact the
> > person who had deleted the note for clarification. Though I personally
> think
> > saying that notes maintainers are overzealous is simply incorrect and may
> > even be interpreted as insulting (yes, I do feel that way), that's not
> the
> > point I'm trying to discuss.
>
>     Well, you're certainly welcome to feel insulted at any time, but
> before you do, consider the facts: I'm a note maintainer as well, and
> I'm also by far the most active.  Thus, if anyone is overzealous at
> times, it's likely to be me.  It wasn't a slight against you (if I
> intended it to be, I'd have CC'd you on the email personally to make
> the point).  I always encourage folks who complain about user note
> removal to contact the editor who removed it so that they can best
> explain their reason for deleting it.  On occasion, I also confer with
> editors (particularly the newer ones) to see their reasoning for
> removing or rejecting notes.  Most often, the reasons are justifiable;
> very rarely (though it does sometimes occur), the editor needs a bit
> of guidance as to what should or should not be removed.
>
>    The most basic guidelines I see to follow as a user note editor
> are the very "dos and don'ts" the note submitter sees when adding a
> note to the documentation.  If there is an obvious violation or
> ignorance of the rules, the note goes.  Then, the guidelines (which
> are not rules, and should never become rules, because it would detract
> from the quality we've had thus far) come into play.  From there, it's
> essentially a subjective process, left to the individual editor as to
> what adds value and what does not.
>
>    Over the years, I've had literally dozens of folks either question
> or complain about my decision to remove a note, and I would say
> roughly one-quarter of the time, through discussion, I'm convinced by
> the submitter that the note does add value.  Probably another
> one-quarter of the time the discussion ends in the submission of
> either a bug report or feature request.  The remaining half is a
> combination of cases where the user simply did not read the
> pre-submission stanzas and either referred to another note or posted
> "improvements" on an existing code snippet; posted an overtly biased
> opinion on the language, site, or project members; linked to their own
> website or blog; or the note just plainly didn't belong in the manual,
> and I wasn't properly convinced otherwise by the submitter.
>
>    When dealing with the notes, the biggest thing to remember is that
> we're editors; we're not here to please the submitting individuals,
> but rather the readers of the manual and attached notes.  That's going
> to piss people off on both sides of the coin at times, and - quite
> frankly - that's just too bad.  As long as the documentation continues
> to be as quality as it has been, my own opinion is that we're still
> doing things just fine.
>
> --
> </Daniel P. Brown>
> Network Infrastructure Manager
> http://www.php.net/
>

Reply via email to