File:  [NetBSD Developer Wiki] / wikisrc / tutorials / how_to_contribute_to_the_netbsd_documentation.mdwn
Revision 1.2: download - view: text, annotated - select for diffs
Sun Feb 5 07:14:36 2012 UTC (6 years, 4 months ago) by schmonz
Branches: MAIN
CVS tags: HEAD

Introduction to NetBSD's documentation 

#   htdocs, NetBSD's website and online documentation infrastructure 

The htdocs infrastructure is based on XML/DocBook 

##   DocBook Pros & Cons 


  * Separation of content from layout 
  * Semantic markup 
  * Easily convertable to other formats, online as well as printed media 
  * Well defined, widely used and standards compliant document format and toolchain 
  * Global changes become more easily accomplished 


  * Editing xml files is not much fun 
  * Additional tools and a huge build infracstructure is needed 

#   NetBSD's system documentation 

This contains the manual pages, the release documentation,... 

CVSweb for NetBSD wikisrc <> software: FreeBSD-CVSweb