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 1IxXYv-0007G0-F3 for garchives@archives.gentoo.org; Thu, 29 Nov 2007 00:47:29 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lAT0k1Li007690; Thu, 29 Nov 2007 00:46:01 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 lAT0hs0B005304 for ; Thu, 29 Nov 2007 00:43:55 GMT Received: by nf-out-0910.google.com with SMTP id f5so1550530nfh for ; Wed, 28 Nov 2007 16:43:54 -0800 (PST) Received: by 10.78.21.7 with SMTP id 7mr1107735huu.1196297034351; Wed, 28 Nov 2007 16:43:54 -0800 (PST) Received: by 10.78.69.11 with HTTP; Wed, 28 Nov 2007 16:43:54 -0800 (PST) Message-ID: Date: Wed, 28 Nov 2007 16:43:54 -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: <20071128211553.GB11126@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> X-Google-Sender-Auth: e34459a744c2b492 X-Archives-Salt: 5bd80599-8f28-4929-a8de-c385e0b59414 X-Archives-Hash: 34c883d997febb315e9dcf97d4630dab 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 -- gentoo-dev@gentoo.org mailing list