RFC: Dealing with version-specific docs

Gabor Kovesdan gabor at FreeBSD.org
Mon Jan 28 11:20:36 UTC 2013


Hi,

as you may know, the printed edition of FreeBSD Handbook is being 
worked. In our current Handbook version, we have version-specific 
information for different major releases, while the printed edition 
shall concentrate on 9.X. We cannot just drop the parts that detail 
older releases since they haven't yet reached EOL and there are people 
out there still using these. So we have to deal somehow with this 
situation. Fortunately, DocBook provides a mechanism, called profiling, 
which we could use. It would also be beneficial for later cleanup work 
since finding outdated information that has to do with unsupported 
releases always requires big effort. I've made a draft about how it 
could be done in a practical way:
https://wiki.freebsd.org/VersionSpecificDocs

Please read it and if you have doubts, concerns or better suggestions, 
please share them.

Thanks in advance,
Gabor


More information about the freebsd-doc mailing list