Fix documentation builds

Zeitsperre commented 1 year ago

Pull Request Checklist:

[ ] This PR addresses an already opened issue (for bug fixes / features)
- This PR fixes #xyz
[ ] (If applicable) Documentation has been added / updated (for bug fixes / features)
[x] This PR does not seem to break the templates.
[x] HISTORY.rst has been updated (with summary of main changes)
- [x] Link to issue (:issue:number) and pull request (:pull:number) has been added

What kind of change does this PR introduce?

Adds some Makefile recipes for the documentation build steps
Removes the llvmlite reinstallation step that was needed a few years ago to deal with some weirdness with ReadTheDocs
Applies a consistent package <comparison><version> schema to environment files

Does this PR introduce a breaking change?

No.

Other information:

RondeauG commented 1 year ago

I somehow can't reproduce the RtD error when running the notebook locally.

RondeauG commented 1 year ago

Alright, I managed to reproduce the error locally. It looks like the culprit is xarray 2023.3.0, which gets installed during: python -m pip install --upgrade --upgrade-strategy eager --no-cache-dir .

Is there a way to prevent that? Incidentally, that command also installs pandas 1.5.3, even though we have pandas!=1.5.3 in environment.yml. Is it because it's not in setup.py?

Ouranosinc / xscen