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