docs: remove legacy docs folder#409
Conversation
conorheins
left a comment
There was a problem hiding this comment.
thanks for this, agree with the motivation in #408 and getting the 5 jinja2 dependabot alerts to disappear as a side effect is a nice bonus.
Two small things before we land:
1. Preserve three orphan notebooks. these have no counterpart anywhere in examples/:
docs/notebooks/active_inference_from_scratch.ipynbdocs/notebooks/pymdp_fundamentals.ipynbdocs/notebooks/using_the_agent_class.ipynb
could you move them into examples/legacy/ before deleting the rest? i think they are useful educational material despite being outdated in terms of referencing numpy backend. that dir is already excluded from the notebook manifests so there won't be any CI overhead. the other three notebooks in docs/notebooks/ (cue_chaining_demo, tmaze_demo, free_energy_calculation) already have counterparts in examples/ so those are fine to drop.
2. stale line to delete. docs-mkdocs/development/viewing-docs.md:34 says `docs/` is retained as legacy Sphinx-era content for compatibility/history. which becomes false after this PR, so worth dropping in the same go.
once those tiny changes are in, think this PR is good to go
🤖 I have created a release *beep* *boop* --- ## [1.0.3](v1.0.2...v1.0.3) (2026-06-08) ### Documentation * **notebooks:** add colab badge and install cell to other notebooks ([#407](#407)) ([c9f8ef9](c9f8ef9)) * **notebooks:** add google colab badge and install cell to model construction notebook ([#406](#406)) ([be658c2](be658c2)) * remove legacy docs folder ([#409](#409)) ([57b09cf](57b09cf)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).
Addresses:
and also:
because we don't use jinja when generating docs the new way