Diff for /wikisrc/tutorials/how_to_contribute_to_the_netbsd_documentation.mdwn between versions 1.1 and 1.2

version 1.1, 2011/11/20 20:55:21 version 1.2, 2012/02/05 07:14:36
Line 1 Line 1
 Introduction to NetBSD's documentation  Introduction to NetBSD's documentation 
   
 #   htdocs, NetBSD's website and online documentation infrastructure  #   htdocs, NetBSD's website and online documentation infrastructure 
   
 The htdocs infrastructure is based on XML/DocBook  The htdocs infrastructure is based on XML/DocBook 
   
 ##   DocBook Pros & Cons  ##   DocBook Pros & Cons 
   
 **Pros**  **Pros**
   
   * Separation of content from layout    * Separation of content from layout 
   * Semantic markup    * Semantic markup 
   * Easily convertable to other formats, online as well as printed media    * Easily convertable to other formats, online as well as printed media 
   * Well defined, widely used and standards compliant document format and toolchain    * Well defined, widely used and standards compliant document format and toolchain 
   * Global changes become more easily accomplished    * Global changes become more easily accomplished 
   
      
 **Cons**  **Cons**
   
   * Editing xml files is not much fun    * Editing xml files is not much fun 
   * Additional tools and a huge build infracstructure is needed    * Additional tools and a huge build infracstructure is needed 
   
 #   NetBSD's system documentation  #   NetBSD's system documentation 
   
 This contains the manual pages, the release documentation,...  This contains the manual pages, the release documentation,... 
   

Removed from v.1.1  
changed lines
  Added in v.1.2


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