Documentation markup experience

Daniel Holbach daniel.holbach at ubuntu.com
Mon May 31 13:33:15 UTC 2010


Hello everybody,

there recently was a discussion about moving Packaging documentation
from the wiki back into some kind of documentation markup format.

The reasons discussed were:

 - generate offline documentation from it easily (.pdf, .html,
   package it etc.)
 - translatability
 - ability to file bugs on it
 - merge proposals
 - better structure
 - possibly others.

I'd like to hear from you what your experiences are with Documentation
markup, particularly from a contributions angle. Also: what is the
current state of the art? Is Mallard simple enough? Is it what we should
be using?

I'm asking you as part of the Packaging Docs blueprint [1] and in order
to prepare the discussion for the developers.

[1] https://blueprints.launchpad.net/ubuntu/+spec/community-m-packaging-docs

PS: Please CC me in replies as I'm not subscribed to the list.

Have a great day,
 Daniel




More information about the ubuntu-doc mailing list