Boost.Graph Documentation Got a Facelift: Ship it Or Not ?

Hi Boost Graph community !

We have taken a first step in modernizing the Boost.Graph documentation with a preview available [here](https://491.graph.prtest3.cppalliance.org/graph/index.html).

These first steps aim at solving low-hanging fruits and answering frequent complaints from users collected during the [2022 User Survey](https://www.reddit.com/r/cpp/comments/vyt4t5/boostgraph_user_survey/) and [BGL workshop 2026 ](https://github.com/boostorg/graph/discussions/466)

* documentation hard to explore (no table of content, no search bar)
* examples use old C++ and several don't even compile
* outdated visual design

We have been investing into several dimensions:

* migrating the old pure html pages to asciidoc + antora
* modern examples for each algorithm are compiled and run in CI, with output integrated in the documentation
* higher scanability for algorithm complexity + where defined
* a better landing for users not familiar with property maps

The PR currently sits unmerged as we are trying to assess its viability.

Important:

* this is NOT the final vision, this is meant as a first important step.
* the current scope is NOT a full rewrite/reorganization of each algorithm page.
* the current scope is a modernization of the documentation infrastructure.
* we are just worried we may have made and missed important mistakes that should prevent the merge

Question to the community:
1. Is the [new documentation preview](https://491.graph.prtest3.cppalliance.org/graph/index.html) going in the right direction?
2. Is it better than [the old documentation](https://www.boost.org/doc/libs/1\_91\_0/libs/graph/doc/)?
3. Would you want to see it merged in its current state or did you identify important mistakes we should absolutely fix before merge?

Any general complaints not directly related to this PR scope is welcome and will be integrated in future work :)

Thank you for your time,


https://redd.it/1u18qqv
@r_cpp