* Re: [gentoo-dev] [RFC] Features and documentation
@ 2007-11-28 6:56 99% ` Rémi Cardona
0 siblings, 0 replies; 1+ results
From: Rémi Cardona @ 2007-11-28 6:56 UTC (permalink / raw
To: gentoo-dev
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.
For bugfix, we already have ChangeLogs.
My 2 euro ¢
Cheers,
Rémi
--
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 99% ` Rémi Cardona
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox