httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ben Laurie <...@gonzo.ben.algroup.co.uk>
Subject Re: documentation
Date Sun, 03 Nov 1996 21:41:06 GMT
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

Mime
View raw message