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
--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--
[EMAIL PROTECTED] www.apache.org hyperreal.com http://www.organic.com/JOBS
