Re: [atomic-devel] Doc format?

["Brian (bex) Exelbierd" <bex pobox com>]

Our RH downstream partners use AsciiDoc.  If we want to ease contributions, allowing that format is suggested.

regards,

bex

> On Mar 7, 2016, at 10:39 PM, Josh Berkus <jberkus redhat com> wrote:
> 
> On 03/07/2016 09:00 AM, Matt Micene wrote:
>> One option would be to pick one and then use pandoc to convert as
>> needed, it supports conversions between asciidoc, markdown, and
>> reStructuredText.
>> 
>> http://pandoc.org/try/ is an online version, you can paste one of the
>> existing PA.io docs into it and see how the conversion looks.  We'd want
>> to add a local version to the workflow, not the online.
> 
> Unfortunately, PanDoc can't convert between AsciiDoc Binder and ReadTheDocs RST without significant loss of structure.
> 
> -- 
> --
> Josh Berkus
> Project Atomic
> Red Hat OSAS
>