On Tue, May 6, 2025 at 7:21 AM Ruben Perez via Boost <boost@lists.boost.org> wrote:
9. I dislike the single-page architecture. I know that Boost.Unordered ( https://www.boost.org/doc/libs/1_88_0/libs/unordered/doc/html/unordered/intr... ) uses Antora to render asciidoc as multiple pages - maybe it's a technology that's worth to explore.
Yes! I forgot to shill this during my review. But yes, the docs are incredibly hard to read because of the single-page format. This is how Unordered has it setup: https://github.com/boostorg/unordered/tree/develop/doc I'd recommend to just blanket copy-paste the Unordered approach and then edit it into something workable. Antora has beautiful documentation output and is dramatically easier to navigate. - Christian