Brian Behlendorf wrote:
>
>
> I am happy with the current CVS architecture for docs. Thank you, Ben, for
> doing this.
>
> I will spend a good chunk of today making sure that's what's in the cvs tree is
> sync'd up with what's in /export/pub/apache/docs right now; I know I've made
> some small incremental changes I probably should have waited for. Eek.
>
> Finally, the directory structure should be more rigorously defined than it is
> now. Right now I *think* the logic is something like this:
>
> docs/ All documentation related to the "current" release of Apache
> Includes various files not specific to a version:
> "security_tips", "vif.info", "perf".
> docs/1.0/ Complete documentation for 1.0
> docs/1.1/ All features in 1.1 not in 1.0
> docs/1.2/ All features in 1.2 not in 1.1
>
> This is pretty inelegant, if you ask me. I think it should be changed to the
> following:
>
> docs/ The "reference" URL for documentation on apache
> Various non-specific-version information files
> docs/1.0/ Complete documentation for 1.0
> docs/1.1/ Complete documentation for 1.1
> docs/1.2/ Complete documentation for 1.2
>
> That way if functionality changes between versions within a given module or
> core, it can be tracked very cleanly.
>
> Let me know what you think.
I think that the whole concept of keeping subdirectories for different versions
is invalidated by the (correct) use of CVS. However, I haven't got time to make
it work properly, so I'll go with this arrangement for now. Be warned that I
intend to improve the situation (with due agreement, of course).
Cheers,
Ben.
>
> Brian
>
> --=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--
> brian@organic.com www.apache.org hyperreal.com http://www.organic.com/JOBS
>
--
Ben Laurie Phone: +44 (181) 994 6435 Email: ben@algroup.co.uk
Freelance Consultant and Fax: +44 (181) 994 6472
Technical Director URL: http://www.algroup.co.uk/Apache-SSL
A.L. Digital Ltd, Apache Group member (http://www.apache.org)
London, England. Apache-SSL author
|