On 9/12/25 5:44 AM, Vinnie Falco via Boost wrote:
On Thu, Sep 11, 2025 at 2:26 PM Nana Sakisaka<aroma.slope.seven@gmail.com> wrote:
I have professional skills on AsciiDoc and I actually plan to migrate the entire Spirit documentation to AsciiDoc. Although we haven't made a consensus on which framework to choose, I believe AsciiDoc is the best and I plan to submit PR.
Yes, and note the following:
asciidoc: the name of the markdown format asciidoctor: the name of a tool which renders asciidoc antora: a publishing framework which renders multipage documentation sets, in asciidoc format
Antora is from the same author as Asciidoctor and it uses the same markdown format. The difference is that regular asciidoctor usually leads to 1-page documentation such as:https://boost.org/libs/describe Whereas Antora is designed for multi-page output such as:https://www.boost.org/libs/url Given the size of the documentation of each of the libraries in Spirit I would advise Antora (which as I said, uses asciidoc markdownj).
I am all for Asciidoc and Antora. I use that now in all my recent libraries. Example: https://cycfi.github.io/q/q/v1.5-dev/reference/synth.html Cheers, -- Joel de Guzman Cycfi Research, Inc.