update docs

RELEASE CHECKLIST.md

@@ -6,7 +6,7 @@
 - locally built docs aren't obviously broken (`cd docs && make html` and check API page)
 - pushed to GitHub
 - docs are (automatically) updated on best.readthedocs.io
-- delete old build files
+- delete old build files (see UPGRADE.txt)
 - build new package
 - release new package
 - new package available on PyPI

TODO.txt

@@ -1,4 +1,8 @@
 add __version__
+pymc 4 support
 
 FutureWarning: In v4.0, pm.sample will return an `arviz.InferenceData` object instead of a `MultiTrace` by default. You can pass return_inferencedata=True or return_inferencedata=False to be safe and silence this warning.
 
+version incompatibility only during test build?
+ERROR: pymc3 3.11.5 has requirement numpy<1.22.2,>=1.15.0, but you'll have numpy 1.22.4 which is incompatible.
+ERROR: pymc3 3.11.5 has requirement scipy<1.8.0,>=1.7.3, but you'll have scipy 1.8.1 which is incompatible.

UPGRADE.txt

@@ -1,19 +1,19 @@
 # https://packaging.python.org/tutorials/packaging-projects/
 
-rm -r best.egg-info dist/* build
+rm -rf best.egg-info dist/* build
 
-pip install --upgrade build
+python3 -m pip install --upgrade build twine
 python3 -m build
 # a .whl and a .tar.gz in the /dist directory
-python3 -m pip install --upgrade twine
 python3 -m twine upload --repository testpypi dist/*
 # if live:
-# python3 -m twine upload dist/*
 
 mktmpenv
-cd - && pip install . && cd -  # install dependencies
+#cd - && pip install . && cd -  # install dependencies
+# TODO install dependencies using install_requirements from setup.py, because pip install . doesn't respect the dependencies of the dependencies
 pip uninstall best
 pip install --index-url https://test.pypi.org/simple/ --no-deps best
 
-# if live:
-# pip install best
+# do it live:
+python3 -m twine upload dist/*
+pip install best