Akademy/2013/DocumentationBoF

Documentation BoF

Some things we might discuss. Other topics are welcomed!

Creation of documentation on UserBase

Pros:

• Everyone can contribute
• Collaborative process
• Many eyes (editrors, translators) - spot problems
• Nice interface for translation

Cons?

• Dockbooc formatting doesn't completely match with UserBase formatting

Tools:

• automated Wiki -> DocBook program in Python (still requires some manual intervention)
• automated DocBook -> Wiki program TBA?
• Better support for interface strings, versionsnumbers ...?
• Better integration with existing tools: Lokalize, pology.

Building teams of documenters

Documentation is a task, that "regular users" can contribute to. May be a good gateway into the community.