On Tue, 11 Mar 2003, Stefano Mazzocchi wrote:
> Diana Shannon wrote:
>
> > 1. Many, many committers weren't updating release and head branches with
> > their doc updates. It took time to scrutinize differences in the
> > branches, to make sure all relevant docs were in the release branch,
> > which is what is used to generate the web site.
>
> Agreed this is a problem.
>
> Hopefully, now that we have two clearly separated repositories, people
> will document only in the appropriate one.
Woah!
I really don't think we want two sets of documentation, do we? It leads to
unnecessary discrepancies, continuity issues and duplication of effort.
There is no reason that I am aware of that we couldn't have one single set
of documentation, and mark content where appropriate as "2.0 only" or "2.1
only". I'm sure that a cocoon-doc cvs module is the right way to go.
Other than that, the rest of the idea for the publishing system sounds
pretty good.
Andrew.
--
Andrew Savory Email: andrew@luminas.co.uk
Managing Director Tel: +44 (0)870 741 6658
Luminas Internet Applications Fax: +44 (0)700 598 1135
This is not an official statement or order. Web: www.luminas.co.uk
|