📚 revise docs incl. notebooks

[aaronspring]

Description

go over all notebooks after #708

To-Do List

• use myst to link py:class:
• change to theme jupyter book theme
• doc/conf.py xr
• https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#role-py-func
• stars forks issues in index.html
• Short ci badges rename
• Rerun all notebooks
• Execute never https://nbsphinx.readthedocs.io/en/pydata-theme/never-execute.html
• in ignore https://stackoverflow.com/questions/40659212/futurewarning-elementwise-comparison-failed-returning-scalar-but-in-the-futur#46721064
• Header run in Binder add manually to each nb in top above title

other PR:

• references in ipynb
• Try https://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#configuration

Type of change

• Improved Documentation

Checklist (while developing)

• CHANGELOG is updated with reference to this PR.

References

• https://github.com/intake/intake-esm/blob/main/docs/source/conf.py
• https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[codecov]

Codecov Report

Merging #709 (591b7da) into main (617223b) will increase coverage by 0.00%.
The diff coverage is 95.23%.

❗ Current head 591b7da differs from pull request most recent head ef61422. Consider uploading reports for the commit ef61422 to get more accurate results

@@           Coverage Diff           @@
##             main     #709   +/-   ##
=======================================
  Coverage   93.85%   93.86%           
=======================================
  Files          59       59           
  Lines        6253     6260    +7     
=======================================
+ Hits         5869     5876    +7     
  Misses        384      384           

Impacted Files	Coverage Δ
climpred/bootstrap.py	90.88% <ø> (ø)
climpred/comparisons.py	95.45% <ø> (ø)
climpred/metrics.py	91.73% <ø> (ø)
climpred/options.py	81.48% <ø> (ø)
climpred/relative_entropy.py	80.73% <ø> (ø)
climpred/stats.py	83.52% <ø> (ø)
climpred/tutorial.py	55.22% <ø> (ø)
climpred/bias_removal.py	95.27% <50.00%> (ø)
climpred/classes.py	94.06% <100.00%> (+<0.01%)	⬆️
climpred/horizon.py	96.55% <100.00%> (ø)
... and 4 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 617223b...ef61422. Read the comment docs.