docs/examples/ holds five notebooks, but mkdocs.yml lists only three. biolink-subsetting.ipynb and denormalizing.ipynb are built and published but unreachable from the site — nothing in the nav links to them.
They aren't abandoned: both are referenced by tests/__init__.py, and they're the reason utils/loaders.py stayed in the package when the unreferenced-source deletion (#297) went through. So they're live enough to constrain the codebase while being invisible to readers.
Either they belong in the nav or they should be retired. Worth an explicit decision rather than leaving them in the gap.
Separate from #254, which is about rewriting tutorial content for CLI-first idioms; this is about whether these two are part of the documentation set at all.
docs/examples/holds five notebooks, butmkdocs.ymllists only three.biolink-subsetting.ipynbanddenormalizing.ipynbare built and published but unreachable from the site — nothing in the nav links to them.They aren't abandoned: both are referenced by
tests/__init__.py, and they're the reasonutils/loaders.pystayed in the package when the unreferenced-source deletion (#297) went through. So they're live enough to constrain the codebase while being invisible to readers.Either they belong in the nav or they should be retired. Worth an explicit decision rather than leaving them in the gap.
Separate from #254, which is about rewriting tutorial content for CLI-first idioms; this is about whether these two are part of the documentation set at all.