1 |
Donnie Berkholz wrote: |
2 |
> How the recent changes happened to allow USE flag descriptions in |
3 |
> metadata.xml (which I'm not taking any position on now) gave me an idea. |
4 |
> The Linux kernel requires that any needed documentation accompany all |
5 |
> changes requiring said documentation -- part of the source-code patch |
6 |
> must apply to the Documentation/ directory. Should we require that |
7 |
> before you commit any changes, you (or someone) write the documentation |
8 |
> for them and commit it or submit a patch at the same time? |
9 |
> |
10 |
> To sum up: No undocumented changes. |
11 |
> |
12 |
> Discuss. |
13 |
> |
14 |
> Thanks, |
15 |
> Donnie |
16 |
> |
17 |
I agree that documentation should be provided before anything is committed. |
18 |
|
19 |
I'd also like to note that documentation was provided with the USE flag |
20 |
descriptions as well as an example metadata.xml with all the new |
21 |
features being used was provided. |
22 |
|
23 |
-- |
24 |
Doug Klima |
25 |
Gentoo Developer |
26 |
-- |
27 |
gentoo-dev@g.o mailing list |