* Re: [gentoo-dev] [RFC] Features and documentation
@ 2007-11-28 18:12 99% ` Zhang Le
0 siblings, 0 replies; 1+ results
From: Zhang Le @ 2007-11-28 18:12 UTC (permalink / raw
To: gentoo-dev
Rémi Cardona wrote:
> Alec Warner wrote:
>> On 11/27/07, Donnie Berkholz <dberkholz@gentoo.org> 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.
>
> What if Donnie had used s/changes/new features/ ? Then his proposal
> makes much more sense.
I agree that new features makes more sense here. USE flag description in
metadata.xml is just an example of new feature, IMO.
My 2 HK$, ;)
--
Zhang Le, Robert
GPG key ID: 1E4E2973
Fingerprint: 0260 C902 B8F8 6506 6586 2B90 BC51 C808 1E4E 2973
--
gentoo-dev@gentoo.org mailing list
^ permalink raw reply [relevance 99%]
Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2007-11-27 19:21 [gentoo-dev] [RFC] Features and documentation Donnie Berkholz
2007-11-28 3:10 ` Alec Warner
2007-11-28 6:56 ` Rémi Cardona
2007-11-28 18:12 99% ` Zhang Le
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox