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 1IxDN9-0000Ul-8n for garchives@archives.gentoo.org; Wed, 28 Nov 2007 03:13:59 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lAS3Cdo6014820; Wed, 28 Nov 2007 03:12:39 GMT Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.189]) by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lAS3AfRE012483 for ; Wed, 28 Nov 2007 03:10:42 GMT Received: by nf-out-0910.google.com with SMTP id f5so1174651nfh for ; Tue, 27 Nov 2007 19:10:41 -0800 (PST) Received: by 10.78.145.14 with SMTP id s14mr48627hud.1196219440845; Tue, 27 Nov 2007 19:10:40 -0800 (PST) Received: by 10.78.69.11 with HTTP; Tue, 27 Nov 2007 19:10:40 -0800 (PST) Message-ID: Date: Tue, 27 Nov 2007 19:10:40 -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: <20071127192144.GP4368@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> X-Google-Sender-Auth: 65ca17053a95eb1c X-Archives-Salt: 6ced7230-46a6-4c72-9ccf-f9b76ef15eaf X-Archives-Hash: 21e5457f3751c4b7ae31072704b4b2e0 On 11/27/07, 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. No, because this is not a realistic requirement, it's an ideal case. People will just commit changes without documentation anyway. > > Discuss. > > Thanks, > Donnie > -- > gentoo-dev@gentoo.org mailing list > > -- gentoo-dev@gentoo.org mailing list