Sphinx 8: WARNING: document isn't included in any toctree [toc.not_included]

[amotl]

Problem

Recent RTD builds started failing out of the blue?

checking consistency... /home/docs/checkouts/readthedocs.org/user_builds/cratedb-toolkit/checkouts/584/doc/readme.md:
WARNING: document isn't included in any toctree [toc.not_included]

-- https://app.readthedocs.org/projects/cratedb-toolkit/builds/30692630/#298313868--73

References

• Sphinx 8: WARNING: document isn't included in any toctree [toc.not_included] daq-tools/lorrystream#218

[amotl]

This is also happening on cratedb-mcp.

• Update sphinx requirement from <8 to <10 cratedb-mcp#108
• https://app.readthedocs.org/projects/cratedb-mcp/builds/30857641/#300163861--27

[amotl]

The workaround is to downgrade to Sphinx 7 like ff21e2a.