Rémi Cardona wrote:
> Alec Warner wrote:
>> On 11/27/07, Donnie Berkholz <firstname.lastname@example.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
email@example.com mailing list