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 1IxXp0-0003MS-Ay for garchives@archives.gentoo.org; Thu, 29 Nov 2007 01:04:06 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lAT13EAM019634; Thu, 29 Nov 2007 01:03:14 GMT Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lAT11EFu017187 for ; Thu, 29 Nov 2007 01:01:14 GMT Received: from gentoo.org (c-67-171-150-177.hsd1.or.comcast.net [67.171.150.177]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id B3616656B2 for ; Thu, 29 Nov 2007 01:01:13 +0000 (UTC) Date: Wed, 28 Nov 2007 17:01:11 -0800 From: Donnie Berkholz To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] [RFC] Features and documentation Message-ID: <20071129010111.GB11249@supernova> References: <20071127192144.GP4368@supernova> <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=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.16 (2007-06-09) X-Archives-Salt: 62fb974b-f5ba-4e63-8171-84f1f1c2f293 X-Archives-Hash: 0cf68bd0d3ed5a8239c8970eebd9afe2 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. Thanks, Donnie -- gentoo-dev@gentoo.org mailing list