Generate user documentation using Mallard

[Philip Peitsch]

Gnome uses a program called Mallard (http://projectmallard.org/) to generate help files from mark-up. I think it would be helpful to stub out an example documentation file, and integrate generation of the resulting documents into the quickly build chain. I suspect some of this might be pushed up into python-distutils-extra.

[Shane Fagan (shanepatrickfagan)]

Gnome hasnt migrated fully to Mallard yet and ubuntu still uses Docbook so I think this one may be for the future.

[Philip Peitsch (philip-peitsch)]

Ahh. I didn't realise! Potentially it might be handy to support Docbook first then? I'm actually not too fussed on which format or system is used... just as long as it can be easily handled as part of the Quickly system (as in compiling out to the final binary forms, etc.)

[Didier Roche-Tolomelli (didrocks)]

As we discussed together, this is clearly the long term way to go.

If you can keep an eye on it, it would be awesome! Thanks again for all your work on Quickly :)

[Didier Roche-Tolomelli (didrocks)]

Hum, it seems that in fact mallard documentation is available in new GNOME, maybe time to convert the Quickly documentation to it?
http://bobthegnome.blogspot.com/2010/02/mallard-documentation.html

[Didier Roche-Tolomelli (didrocks)]

some pointers from james_w:
http://projectmallard.org/about/learn/index.html
http://gitorious.org/empathy-mallard/empathy-mallard

[Philip Peitsch (philip-peitsch)]

I'll take a crack at it tonight and see how far I get :)

[Michael Terry (mterry)]

This got done by Tony recently.