Alec Warner wrote: > On 11/27/07, Donnie Berkholz <[EMAIL PROTECTED]> 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 -- [EMAIL PROTECTED] mailing list
