I WANT YOU, to give me your feedback (Juju docs!)

[Curtis Hovey-Canonical]

On Fri, Mar 21, 2014 at 1:47 PM, Marco Ceppi <marco.ceppi at canonical.com> wrote:
> I'm spreading this email out across the juju-core, juju, and juju-gui list
> to start a discussion about the next format for the docs. Currently, I've
> worked on a proof of concept to converting the docs to Markdown and it's
> going really well. Using python-markdown with a few custom plugins to handle
> the unique user friendly features the docs provide.
>
> However, I wanted to get feedback on the choice of formatting. Markdown has

+1

Caveat that I think we need a post proc to format input examples and
output examples and possibly glossary links.

Given that 1.18.0 can be out next week. 1.18.0's docs will be written
in the current HTML format so that we can deliver them next week
too...unless you happen to already have tip and unstable docs already
converted to markdown and a post processor ready to go.


-- 
Curtis Hovey
Canonical Cloud Development and Operations
http://launchpad.net/~sinzui