Re: Recommendations for documentation authors

From: René Ferdinand Rivera Morell (grafikrobot_at_[hidden])
Date: 2024-01-02 17:28:21

On Tue, Jan 2, 2024, 12:00 PM Vinnie Falco via Boost <boost_at_[hidden]>
wrote:

>
> Now here is one datapoint which pretty much speaks for itself:
>
> Peter Dimov and René Ferdinand Rivera Morell use Asciidoctor (
> https://asciidoctor.org/).

An additional point.. I was one of maintainers Quickbook, boostbook, and
the b2 support for them. And I gave up on them long ago because of the huge
difficulties in the tools.

I find asciidoctor to be well maintained and very flexible in it's
features. All documentation I write now is with asciidoc including: b2,
predef, a variety of wg21 papers, and many more. Key features I like: I can
write reference docs directly in the cpp source code, I can include images
and SVG, I get live render in vscode.

René