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 1Ix6Ex-0002ni-GI for garchives@archives.gentoo.org; Tue, 27 Nov 2007 19:37:03 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lARJZUDS006843; Tue, 27 Nov 2007 19:35:30 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 lARJV9da030938 for ; Tue, 27 Nov 2007 19:31:09 GMT Received: from [192.168.1.55] (shop.monetra.com [216.155.111.10]) by nameserver1.mcve.com (Postfix) with ESMTP id BB3661128EF6 for ; Tue, 27 Nov 2007 14:31:07 -0500 (EST) Message-ID: <474C707B.3090908@gentoo.org> Date: Tue, 27 Nov 2007 14:31:07 -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> In-Reply-To: <20071127192144.GP4368@supernova> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Archives-Salt: 572620af-a26a-46a1-9776-40661430f4b6 X-Archives-Hash: 4e43b80a10e740ce4de1b4943be586af Donnie Berkholz wrote: > How the recent changes happened to allow USE flag descriptions in > metadata.xml (which I'm not taking any position on now) gave me an idea. > The Linux kernel requires that any needed documentation accompany all > changes requiring said documentation -- part of the source-code patch > must apply to the Documentation/ directory. Should we require that > before you commit any changes, you (or someone) write the documentation > for them and commit it or submit a patch at the same time? > > To sum up: No undocumented changes. > > Discuss. > > Thanks, > Donnie > I agree that documentation should be provided before anything is committed. I'd also like to note that documentation was provided with the USE flag descriptions as well as an example metadata.xml with all the new features being used was provided. -- Doug Klima Gentoo Developer -- gentoo-dev@gentoo.org mailing list