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