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

[Marco Rietveld]

Hi all,

Indeed, I'm working on DocbookRX actively, and we have a couple of internal ruby developers who will be working on more complicated 
features/pull requests (macro/conditions, in particular).

We're using Docbookrx to translate all of the community Drools/jBPM documentation as well as all of the corresponding BRMS and BPMS 
product documentation. We're aiming to get all of this done in the next month or two.

("We" is me (a jBPM engineer) and the BSIG documentation team.)

If you have any questions, please feel free to contact me on- or off-list!

Thanks,
Marco


On 2016-05-25 16:46, Jason Porter wrote:
> Hi all, adding the asciidoc list here. There's some work going on around docbookrx [1] to make it a better conversion utility. I
> strong recommend looking it (if you're converting from docbook) and other tools those on the asciidoc list know about.
>
> [1] https://github.com/asciidoctor/docbookrx
>
> On Tue, May 24, 2016 at 4:53 AM, Brian (bex) Exelbierd <bex at pobox.com <mailto:bex at pobox.com>> wrote:
>
>     On 05/23/2016 08:44 PM, Josh Berkus wrote:
>
>         On 05/23/2016 06:03 AM, Preeti Chandrashekar wrote:
>
>             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.
>
>
>         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 <http://readthedocs.org>, which requires a different format.
>
>
>     The initial goal is to port just ADB, vagrant-service-manager, and adb-utils.  Other projects should be considered on a
>     case-by-case basis.
>
>
>     regards,
>
>     bex
>
>     _______________________________________________
>     Devtools mailing list
>     Devtools at redhat.com <mailto:Devtools at redhat.com>
>     https://www.redhat.com/mailman/listinfo/devtools
>
>
>
>
> --
> Jason Porter
> Senior Software Engineer
> developers.redhat.com <http://developers.redhat.com>