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 ) 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 ; Thu, 29 Nov 2007 02:25:21 GMT Received: by nf-out-0910.google.com with SMTP id f5so1578468nfh for ; 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: Date: Wed, 28 Nov 2007 18:25:19 -0800 From: "Alec Warner" 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: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail 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> <20071128211553.GB11126@supernova> <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 wrote: > On 16:43 Wed 28 Nov , Alec Warner wrote: > > On 11/28/07, Donnie Berkholz 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