File:  [NetBSD Developer Wiki] / wikisrc / tutorials / how_to_contribute_to_the_netbsd_documentation.mdwn
Revision 1.1: download - view: text, annotated - select for diffs
Sun Nov 20 20:55:21 2011 UTC (2 years, 4 months ago) by mspo
Branches: MAIN
CVS tags: HEAD
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,... 


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb