About The NetBSD documentation - general informations and overview

From NetBSD Wiki

Jump to: navigation, search

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

Retrieved from "http://wiki.netbsd.se/About_The_NetBSD_documentation_-_general_informations_and_overview"
Personal tools