Re: [OpenMethod] review starts on 28th of April

From: Christian Mazakas (christian.mazakas_at_[hidden])
Date: 2025-05-06 14:37:55

On Tue, May 6, 2025 at 7:21 AM Ruben Perez via Boost <boost_at_[hidden]>
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/intro.html
> )
> 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