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 1IxkiT-0007cq-LP for garchives@archives.gentoo.org; Thu, 29 Nov 2007 14:50:14 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lATEnMwi026974; Thu, 29 Nov 2007 14:49:22 GMT Received: from nameserver1.mcve.com (nameserver1.mcve.com [216.155.111.1]) by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lATElPBo024591 for ; Thu, 29 Nov 2007 14:47:25 GMT Received: from [192.168.1.55] (shop.monetra.com [216.155.111.10]) by nameserver1.mcve.com (Postfix) with ESMTP id 389771148394 for ; Thu, 29 Nov 2007 09:47:24 -0500 (EST) Message-ID: <474ED0FC.1090702@gentoo.org> Date: Thu, 29 Nov 2007 09:47:24 -0500 From: Doug Klima User-Agent: Thunderbird 2.0.0.9 (X11/20071115) 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 To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] [RFC] Features and documentation References: <20071127192144.GP4368@supernova> <20071128211553.GB11126@supernova> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Archives-Salt: c60e4022-0285-4d50-a5b0-ad77a3ea2fb1 X-Archives-Hash: 35aebf93cb5af7c1045984d697282b47 Alec Warner wrote: > On 11/28/07, Donnie Berkholz wrote: > >> On 19:10 Tue 27 Nov , Alec Warner wrote: >> >>> No, because this is not a realistic requirement, it's an ideal case. >>> People will just commit changes without documentation anyway. >>> >> 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. > > 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. > > -Alec > Load of crap. I wrote full documentation and provided patches to the Developer Handbook, where metadata is documented. A GLEP is a terrible place to document this since you have to read through 5 different GLEPs and automatically cross out the parts that are no longer valid or have been replaced by newer parts of the GLEP. Which is why once again, the GLEP is stupid and one central location on one topic should be kept up to date. As I have done. -- gentoo-dev@gentoo.org mailing list