Documentation markup experience

Daniel Holbach daniel.holbach at ubuntu.com
Mon Jun 7 10:10:15 UTC 2010


Hello everybody,

Am 31.05.2010 15:33, schrieb Daniel Holbach:
> 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.

Any experiences you can share?

Have a great day,
 Daniel




More information about the ubuntu-doc mailing list