tools/docs/gen_api_reference.py emits a page only for modules with a non-empty __all__. osrlib/core/__init__.py and osrlib/crawl/__init__.py have none, so the subpackage front pages written in #96 and #97 never reach the site. The crawl one holds the only end-to-end runnable program in its batch (characters, party, adventure, session, EnterDungeon, MoveParty), and a reader on the published reference cannot see it.
The fix is in the generator: emit a page for each layer's package (osrlib.core, osrlib.crawl) rendering the module docstring with members: false, and put it at the top of that layer's section in SUMMARY.md and the index. Adding __all__ to the packages would be the wrong fix, because the package root re-exports nothing by design.
Found during the docstring pass (#87 to #99).
tools/docs/gen_api_reference.pyemits a page only for modules with a non-empty__all__.osrlib/core/__init__.pyandosrlib/crawl/__init__.pyhave none, so the subpackage front pages written in #96 and #97 never reach the site. The crawl one holds the only end-to-end runnable program in its batch (characters, party, adventure, session,EnterDungeon,MoveParty), and a reader on the published reference cannot see it.The fix is in the generator: emit a page for each layer's package (
osrlib.core,osrlib.crawl) rendering the module docstring withmembers: false, and put it at the top of that layer's section inSUMMARY.mdand the index. Adding__all__to the packages would be the wrong fix, because the package root re-exports nothing by design.Found during the docstring pass (#87 to #99).