Annotation of wikisrc/tutorials/how_to_contribute_to_the_netbsd_documentation.mdwn, revision 1.2

1.2     ! schmonz     1: Introduction to NetBSD's documentation 
        !             2: 
        !             3: #   htdocs, NetBSD's website and online documentation infrastructure 
        !             4: 
        !             5: The htdocs infrastructure is based on XML/DocBook 
        !             6: 
        !             7: ##   DocBook Pros & Cons 
        !             8: 
        !             9: **Pros**
        !            10: 
        !            11:   * Separation of content from layout 
        !            12:   * Semantic markup 
        !            13:   * Easily convertable to other formats, online as well as printed media 
        !            14:   * Well defined, widely used and standards compliant document format and toolchain 
        !            15:   * Global changes become more easily accomplished 
        !            16: 
        !            17:   
        !            18: **Cons**
        !            19: 
        !            20:   * Editing xml files is not much fun 
        !            21:   * Additional tools and a huge build infracstructure is needed 
        !            22: 
        !            23: #   NetBSD's system documentation 
        !            24: 
        !            25: This contains the manual pages, the release documentation,... 
        !            26: 

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