Thursday 18th June, 2009
5:00pm to 5:45pm
Documentation for open source projects is every bit as important as the code itself. Without documentation, users frequently get lost or frustrated. But with limited time to work on your project, how can you create a single source of docs that can be used in a variety of ways, such as in downloadable PDFs, or as searchable web content? And how can you engage with localization (translation) communities to spread your content further?
Many people are not aware of the incredible power and versatility of the documentation system known as DocBook, nor how it works. This session will cover what it is, what it isn't, and some of flexible, useful (and in a couple cases, new and shiny) tools that exist to quickly and easily produce fantastic looking content for your users worldwide.
This presentation will cover a few basic XML tenets, DocBook XML, a couple of general-purpose libxml2 and libxslt tools, and Publican, a complete system for turning DocBook XML source into an attractive publication in any of a number of formats.
Musician, Linux geek, hubby & dad, and all-around super guy. bio from Twitter
Sign in to add slides, notes or videos to this session