httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Brian Behlendorf <br...@organic.com>
Subject Re: documentation
Date Sun, 03 Nov 1996 22:06:36 GMT

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.

	Brian

--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--
brian@organic.com  www.apache.org  hyperreal.com  http://www.organic.com/JOBS


Mime
View raw message