DocOps at Flow 2022

This repository follows the discussion at the round table "DocOps for system analyst" held at Flow 2022.

It defines Kotlin DSL Asciidoc wrapper and contains a report on DocOps talks at Flow. The report is written with the help of this wrapper. The report is published at Habr.

Outputs formats

• Html

• Pdf

• Microsoft Word (docx)

• Habr Markdown (published here)

• Just text

Some notes

• Wrapper allows creating Asciidoc files and Habr MarkDown files for publishing at Habr

• Only a subset of Asciidoc directives necessary for the Habr post is implemented

• Applying Language Tools during abstract syntax tree construction and throwing exception in the case of grammar error is a quick way to navigate to the source of error via stack trace

• Plus sign (+) in text doesn’t mean string concatenation. It is an overloaded operator that adds inline fragment to paragraph object

• To check whether inline text is really inline text and doesn’t contain any Asciidoc inline or even block macros, AsciidoctorJ(Java Bindings for Asciidoctor) is used

• MS Word and pdf outputs are created with the help of Open Document converter for Asciidoctor