Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-dev
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-dev@g.o
From: Duncan <1i5t5.duncan@...>
Subject: Re: news item: Portage's config-protect-if-modified feature is enabled by default
Date: Fri, 18 May 2012 10:09:16 +0000 (UTC)
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



References:
news item: Portage's config-protect-if-modified feature is enabled by default
-- Zac Medico
Re: news item: Portage's config-protect-if-modified feature is enabled by default
-- Michał Górny
Re: news item: Portage's config-protect-if-modified feature is enabled by default
-- Zac Medico
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: news item: Portage's config-protect-if-modified feature is enabled by default
Next by thread:
Lastrite: app-arch/hardlink++
Previous by date:
Re: Re: RFC: Add new remote-id types in metadata.dtd
Next by date:
Re: Re: Stability of /sys api


Updated Jun 29, 2012

Summary: Archive of the gentoo-dev mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.