<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 05/23/2016 03:33 PM, Preeti
Chandrashekar wrote:<br>
</div>
<blockquote
cite="mid:CAGo5tzOYHUUdKUbZTR1WebcDzc9mG_1ppTXVZ-vrp72AUq4y9Q@mail.gmail.com"
type="cite">
<div dir="ltr"><span style="font-size:12.8px">Hi All,</span>
<div style="font-size:12.8px"><br>
</div>
<div style="font-size:12.8px"><span style="font-size:12.8px">In
line with our ongoing efforts at streamlining the docs
process, and in order to ensure better upstream-downstream
coordination, we are </span><span style="font-size:12.8px">proposing
to move to the Asciidoc format for docs </span><span
style="font-size:12.8px">related to container development
tools in Project Atomic</span><span style="font-size:12.8px">.</span><br>
</div>
<div style="font-size:12.8px"><br>
</div>
<div style="font-size:12.8px">Adoption of Asciidoc would:</div>
<div style="font-size:12.8px">- <span style="font-size:12.8px">allow </span><span
style="font-size:12.8px">us to leverage existing code for
publishing to </span><a moz-do-not-send="true"
href="http://docs.projecatomic.io/" rel="noreferrer"
target="_blank" style="font-size:12.8px">docs.projecatomic.io</a>.</div>
<div style="font-size:12.8px">- <span style="font-size:12.8px">allow
for easier contribution by downstream </span><span
style="font-size:12.8px">communities that have standardized
on Asciidoc.</span></div>
<div style="font-size:12.8px"><span style="font-size:12.8px"><br>
</span></div>
<div style="font-size:12.8px"><span style="font-size:12.8px">AsciiDoc
belongs to the family of lightweight markup languages, the
most renowned of which is Markdown [1]. It is very similar
to markdown in terms of formatting and is not that steep a
curve in terms of learning [2].</span><span
style="font-size:12.8px"><br>
</span></div>
<div style="font-size:12.8px"><span style="font-size:12.8px"><br>
</span></div>
<div style="font-size:12.8px"><span style="font-size:12.8px">Please
let us know what you think about this so that the docs team
can freeze on the process.</span><span
style="font-size:12.8px"><br>
</span></div>
<div style="font-size:12.8px"><span style="font-size:12.8px"><br>
</span></div>
<div style="font-size:12.8px">
<div style="font-size:12.8px">[1] [<a moz-do-not-send="true"
href="http://asciidoctor.org/docs/what-is-asciidoc/"
target="_blank">http://asciidoctor.org/docs/what-is-asciidoc/</a>]</div>
<div style="font-size:12.8px">[2] [<a moz-do-not-send="true"
href="http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/"
target="_blank">http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/</a>]</div>
<div style="font-size:12.8px"><br>
</div>
<div style="font-size:12.8px">Thank you,</div>
<div style="font-size:12.8px">Regards,</div>
<div style="font-size:12.8px">Preeti</div>
</div>
</div>
</blockquote>
<p>+1 for ascii doc. Have you looked in to tools for doing mass
conversion of docs already exists in reStructuredText and makrdown
to ascii doc? So that the move will become relatively smooth.</p>
<p><br>
</p>
<p>Thanks,</p>
<p>Lala<br>
</p>
<p><br>
</p>
<p><br>
</p>
<p><br>
</p>
</body>
</html>