From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-dev+bounces-27794-garchives=archives.gentoo.org@gentoo.org>)
	id 1IxZ8O-00088N-Nx
	for garchives@archives.gentoo.org; Thu, 29 Nov 2007 02:28:13 +0000
Received: from robin.gentoo.org (localhost [127.0.0.1])
	by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lAT2RMAO004832;
	Thu, 29 Nov 2007 02:27:22 GMT
Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.188])
	by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lAT2PLMt002406
	for <gentoo-dev@lists.gentoo.org>; Thu, 29 Nov 2007 02:25:21 GMT
Received: by nf-out-0910.google.com with SMTP id f5so1578468nfh
        for <gentoo-dev@lists.gentoo.org>; Wed, 28 Nov 2007 18:25:21 -0800 (PST)
Received: by 10.78.176.20 with SMTP id y20mr43833hue.1196303119551;
        Wed, 28 Nov 2007 18:25:19 -0800 (PST)
Received: by 10.78.69.11 with HTTP; Wed, 28 Nov 2007 18:25:19 -0800 (PST)
Message-ID: <b41005390711281825i2e5bbf8dt655f95a3c605b480@mail.gmail.com>
Date: Wed, 28 Nov 2007 18:25:19 -0800
From: "Alec Warner" <antarus@gentoo.org>
Sender: antarus@scriptkitty.com
To: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] [RFC] Features and documentation
In-Reply-To: <20071129010111.GB11249@supernova>
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <20071127192144.GP4368@supernova>
	 <b41005390711271910n74d15a96w16681f40294a5fa@mail.gmail.com>
	 <20071128211553.GB11126@supernova>
	 <b41005390711281643w4e579e59j55cc0c74358b72fe@mail.gmail.com>
	 <20071129010111.GB11249@supernova>
X-Google-Sender-Auth: 1685e9b0b6e4cc91
X-Archives-Salt: 429c7d84-e6f3-4960-a94e-a6fbf27fe0ba
X-Archives-Hash: 1a164853bb27fe224596b44592b76548

On 11/28/07, Donnie Berkholz <dberkholz@gentoo.org> wrote:
> On 16:43 Wed 28 Nov     , Alec Warner wrote:
> > On 11/28/07, Donnie Berkholz <dberkholz@gentoo.org> wrote:
> > > Here's my understanding of what you said: Because people will break
> > > rules and violate standards, we shouldn't have any.
> > >
> > > Is that accurate?
> > >
> >
> > Kind of.
> >
> > Most people follow most rules.  Most people break a subset of rules.
> >
> > You are essentially adding an unreasonable (in my view) rule that I
> > expect nearly everyone to break or ignore, thereby adding little or no
> > value to the project as whole.  Most people care about documentation
> > in the abstract sense, almost no one cares *enough* to write any ;)
> >
> > Forcing people to write documentation won't get it written, people
> > will continue to act like we just saw and either the rule will get
> > ignored, or someone will change the rule, or people will leave because
> > the rule is enforced aggressively and it has ruined the ability to
> > contribute to the project.
>
> The Linux kernel seems to still have contributors, despite its
> requirement. It seems like people decide to leave after nearly any
> change Gentoo makes these days, so I'm not even sure how much we should
> consider that unless we want to stop all development and do nothing.
> (But I guess that also would be a change, so people would quit.)
>
> > This is why I offered to write the GLEP for Diego and Cardoe, because
> > I know they are not interested in writing it themselves.  Thats why we
> > have a doc-team that for some sick reason enjoy writing and
> > maintaining documentation.
>
> You've made some great points here about working with people who enjoy
> dealing with docs. What I'm saying is that we should work with these
> people before committing rather than after.
>

I can get behind that then ;)

> Thanks,
> Donnie
> --
> gentoo-dev@gentoo.org mailing list
>
>
-- 
gentoo-dev@gentoo.org mailing list