<div dir="ltr"><span style="font-family:arial,sans-serif;font-size:13px">I +1 for Markdown.</span><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">

Everybody on github uses markdown (go ahead, flame me with the 10 other variants it supports - markdown is the dominant one there)</div><div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">

I use it in my blogging, for mind mapping, for pretty much everything I do. Its a fluid syntax that lets me regurgitate content and intent instead of spending time doing tedious formatting with an XML format that I have actively sought to replace with tech like SLIM and HAML.</div>

<div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">This has implications on ease of i18n conversion as well (with the assumption there are python tools similar to whats available in camp ruby)</div>

<div style="font-family:arial,sans-serif;font-size:13px"><br></div><div style="font-family:arial,sans-serif;font-size:13px">MAKE THIS HAPPEN! </div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Mar 21, 2014 at 1:47 PM, Marco Ceppi <span dir="ltr"><<a href="mailto:marco.ceppi@canonical.com" target="_blank">marco.ceppi@canonical.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hi everyone,<div><br></div><div>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.</div>


<div><br></div><div>However, I wanted to get feedback on the choice of formatting. Markdown has quickly become the choice of formatting for new projects, it's used heavily on the StackExchange network as well as Github. It's even a recommendation for the charm README files and charm-tools creates a Markdown template for use. Finally, it bares similarities to RST but tends to be more forgiving and require less syntax to use.</div>


<div><br></div><div>To quote the John Gruber, Markdown creator:</div><div><br></div><div>> While Markdown’s syntax has been influenced by several existing text-to-HTML filters, the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.</div>


<div><br></div><div>This low barrier of entry is likely one of the reasons it's grown in popularity over the years.</div><div><br></div><div>I'm curious of people's opinions, do you support this move to Markdown? Do you have other formats for docs in mind and if so reasons that style instead? After some time I'll consider the responses, for and against, as a poll for which language to move the docs to as I finish my conversion</div>


<div><br></div><div>Thanks,<br>Marco Ceppi</div></div>
<br>--<br>
Juju mailing list<br>
<a href="mailto:Juju@lists.ubuntu.com">Juju@lists.ubuntu.com</a><br>
Modify settings or unsubscribe at: <a href="https://lists.ubuntu.com/mailman/listinfo/juju" target="_blank">https://lists.ubuntu.com/mailman/listinfo/juju</a><br>
<br></blockquote></div><br></div>