[Container-tools] Proposal - Moving container development tools docs to the Asciidoc format

[Preeti Chandrashekar]

Hi All,

In line with our ongoing efforts at streamlining the docs process, and in
order to ensure better upstream-downstream coordination, we are proposing
to move to the Asciidoc format for docs related to container development
tools in Project Atomic.

Adoption of Asciidoc would:
- allow us to leverage existing code for publishing to docs.projecatomic.io.
- allow for easier contribution by downstream communities that have
standardized on Asciidoc.

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].

Please let us know what you think about this so that the docs team can
freeze on the process.

[1] [http://asciidoctor.org/docs/what-is-asciidoc/]
[2] [http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/]

Thank you,
Regards,
Preeti
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/container-tools/attachments/20160523/13475508/attachment.htm>