Boost logo

Boost :

Subject: [boost] Asciidoc, an alternative for documentation
From: Peter Dimov (lists_at_[hidden])
Date: 2017-06-06 03:00:17

I've been experimenting with Asciidoc-based documentation, using
Boost.Assert as my guinea pig. The good thing about Asciidoc is that Github
shows a preview and you can edit it directly on This is how the
source looks there:

This is how the generated HTML documentation looks, using the default
stylesheet, without any customizations on my part:

And this is how the generated PDF looks:

The tool that produces these is Asciidoctor, .

Boost list run by bdawes at, gregod at, cpdaniel at, john at