[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: [atomic-devel] Proposal - Moving container development tools docs to the Asciidoc format

On 05/26/2016 03:26 PM, Stephen Milner wrote:
On Mon, May 23, 2016 at 2:44 PM, Josh Berkus <jberkus redhat com> wrote:
I'm happy for this to be our default, but I'm concerned about making
existing projects port their docs.  For one thing, at least a couple of
projects make use of readthedocs.org, which requires a different format.

Agreed. Commissiare makes use of reST for readthedocs and, AFAIK,
there is no planned support at RTD for asciidoc or other formats. I've
not personally tried pandoc to see how well it would convert between
the two but that may be an option for those of us currently on RTD.

I don't think we need to do a conversion. docs.pa.o is theoretically able to accept anything with a known conversion toolchain to html, which reST does.

The question I think we need to answer is do you want to publish the docs in two places or not. If not, which source is considered authoritative and which should have a redirect?



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]