Gentoo Archives: gentoo-dev

From: Duncan <1i5t5.duncan@×××.net>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] Re: news item: Portage's config-protect-if-modified feature is enabled by default
Date: Fri, 18 May 2012 10:10:44
Message-Id: pan.2012.05.18.10.09.16@cox.net
In Reply to: Re: [gentoo-dev] news item: Portage's config-protect-if-modified feature is enabled by default by Zac Medico
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 <zmedico@g.o> >> wrote: >> >>> I'd like to commit this news item on 2012-05-21. See previous >>> discussion here: >>> >>> http://archives.gentoo.org/gentoo-dev/
msg_7fe557809defad4faca2ee5c6e52d134.xml
>> >> 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 information. 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