optimagic-dev / optimagic

optimagic is a Python package for numerical optimization. It is a unified interface to optimizers from SciPy, NlOpt and other packages. optimagic's minimize function works just like SciPy's, so you don't have to adjust your code. You simply get more optimizers for free. On top you get diagnostic tools, parallel numerical derivatives and more.
https://optimagic.readthedocs.io/
MIT License
270 stars 30 forks source link

Improve handling of notebooks in documentation #422

Closed janosg closed 1 year ago

janosg commented 1 year ago

What would you like to enhance and why? Is it related to an issue/problem?

We would like to execute most notebooks during each sphinx build, such that it becomes impossible to get outdated notebooks. Notebooks with very long runtime (e.g. this) or notebooks with optional dependencies need to be excluded.

See the discussion #420 for background.

Tasks

Potential alternatives

It is possible that this is still too demanding for readthedocs hardware. Last time we tried, we failed in the environment creation. In that case we could use a local pre-commit hook to run all notebooks that have changed.