making review/bug filing optional for some docs changes
Gervase Markham
gerv at mozilla.org
Fri Mar 18 18:32:26 UTC 2005
David Miller wrote:
> Personally I'm not against having trusted folks making small changes in
> the docs. Making wide sweeping changes or changing the content (rather
> than just the presentation) of the docs are things that should certainly
> continue to require review though.
But it's the wide, sweeping changes which are hard to review, because
they tend to be done incrementally and patches tend to be very fragile.
We don't have to have the same policy in all parts of the development
cycle - after all, the code has an open period and a freeze period. How
about something like: when the code is not frozen, people can update the
docs without patch review. If they want to make structural changes, they
need pre-implementation review of the _concept_ - so core docs people
don't turn up one day to find the entire repository rearranged. Once the
code is frozen, all docs patches have review and approval as normal.
The idea is that this flexibility and fluidity means that the docs are
generally in better shape on an ongoing basis, rather than being fixed
up at the last minute - so there's much less _need_ for the big changes
during a freeze period, because the docs at the start of the freeze are
much closer to the final thing. So the review requirement during the
freeze is not onerous either.
Gerv
More information about the developers
mailing list