Zac Medico posted on Thu, 17 May 2012 23:08:51 -0700 as excerpted:
> On 05/17/2012 08:56 PM, Michał Górny wrote:
>> On Thu, 17 May 2012 14:44:42 -0700 Zac Medico <email@example.com>
>>> I'd like to commit this news item on 2012-05-21. See previous
>>> discussion here:
>> Hmm, I think your should elaborate more on what the effects will be to
>> the final user.
> I think they should be competent enough to understand the effects. If
> you want to provide a patch to the news item then, adding whatever
> elaboration you think is necessary, then I'll gladly apply it.
Indeed, the news item already refers people to the manpage for more
While a good gentooer certainly appreciates good documentation, it's not
about handholding, and from my point of view the manpage documentation
really is pretty good. If they don't know what to do with a referral to
a manpage (or from the direct lookup in that manpage to the general
config-protect info in the same manpage, and from there to the config
files section of the emerge manpage where there's several paragraphs of
coverage), I'd say "ubuntu's over that-a-way, and mint's over there!"
New items should be brief and to the point, serving more as a road sign
with only an arrow letting people know there's a change in direction
ahead with an expectation that the driver seeing it can follow the arrow
and look at what's coming once so alerted, than a complete reference work
of their own. Really, as a user, that's what I want and need, that road-
sign telling me what direction the road is turning, not a full
description of all the engineering data contained in the road-building
documents, that I couldn't read at road speed anyway.
And that's what this is, as it is. =:^)
Duncan - List replies preferred. No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master." Richard Stallman