Re: Proposal: Abandoning monolithic Boost documentation.

From: oliver.kowalke_at_[hidden]
Date: 2025-04-18 18:45:44

At what point is a boost documentation considered modular? I'd like to avoid rewriting the docs for my libraries.

18.04.2025 18:54:23 René Ferdinand Rivera Morell via Boost <boost_at_[hidden]>:

> Today, in slack, we had a discussion on problems with building the
> monolithic docs. For context what I'm calling the monolithic docs are these
> <https://www.boost.org/doc/libs/1_88_0/doc/html/libraries.html>. The main
> problem that was raised is that a failure in one library causes all the
> docs to disappear. That problem is due to the nature of DocBook, XSLT, and
> the single monolithic generation. This is not something that can be
> resolved at the build system leve. The one solution is to abandon the
> monolithic build. And instead move to only having per library documentation
> builds. Hence..
> 
> I am proposing we abandon the monolithic documentation build. The benefits:
> 
> * No longer missing docs from problems in individual libraries.
> * It's modular. I.e. libraries would build, and include, their docs in the
> modular layout.
> 
> Do note that most libraries, more than 2/3, already use modular
> documentation. So technically this would be completing the modular
> transition that has already been happening.
> 
> Thoughts?
> 
> 
> -- 
> -- René Ferdinand Rivera Morell
> -- Don't Assume Anything  -- No Supongas Nada
> -- Robot Dreams - http://robot-dreams.net
> 
> _______________________________________________
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost