[CozySocksAlways]

Summary

• Upgrade to new GitHub Actions versions in CI_actions.yml

• Dropped redundant python-versions from docs job in favor of a single python version

• Expand the tests job's Python version matrix to 3.8–3.14

• Replace the docs job's dependency install (requirements-docs.txt + conda pandoc) with apt install pandoc and pip install ., keeping up with the pyproject.toml migration in Migrate packaging from setup.py to pyproject.toml #82

• Other general cosmetic changes also made

• Document when stricter doc build options can be enforced in CI doc build

[kohlerca]

The changes and updates in the CI workflow look good to me.

However, I identified that during the documentation build, there is a non-fatal failure in plot_patterns_hypergraph and plot_ue, which prevents the plots from showing in the documentation. I would expect those errors to fail one job in the CI.

This is somewhat independent from this refactoring PR, although we should have those errors flagged.

[CozySocksAlways]

The changes and updates in the CI workflow look good to me.

However, I identified that during the documentation build, there is a non-fatal failure in plot_patterns_hypergraph and plot_ue, which prevents the plots from showing in the documentation. I would expect those errors to fail one job in the CI.

This is somewhat independent from this refactoring PR, although we should have those errors flagged.

Thanks for going through the logs to find those silent failures!
So I looked into them, one of them was an easy fix, I swapped out a numpy.stack with a list comprehension to avoid a shape mismatch in the doc strings example
The other one with holoviews will hopefully be fixed with the PR #77 .
I also would suggest once PR #77 or a later one to add stricter doc build check with the sphinx options in CI build. Something like make html SPHINXOPTS="-W --keep-going" should cause a doc build fail when such exceptions happen in the future.

[kohlerca]

I also would suggest once PR #77 or a later one to add stricter doc build check with the sphinx options in CI build. Something like make html SPHINXOPTS="-W --keep-going" should cause a doc build fail when such exceptions happen in the future.

Looks like a good plan.