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

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

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!


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 pobox com <mailto:bex 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.



    Devtools mailing list
    Devtools redhat com <mailto:Devtools redhat com>

Jason Porter
Senior Software Engineer
developers.redhat.com <http://developers.redhat.com>

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