Return to how_to_contribute_to_the_netbsd_documentation.mdwn CVS log

Up to [NetBSD Developer Wiki] / wikisrc / tutorials

import all of the how-to articles from the pkgsrc.se wiki

Introduction to NetBSD's documentation 

#   htdocs, NetBSD's website and online documentation infrastructure 

The htdocs infrastructure is based on XML/DocBook 

##   DocBook Pros & Cons 

**Pros**

  * 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 

  
**Cons**

  * 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,...