improve docs

[aaronspring]

Description

• http://www.pydocstyle.org/en/4.0.0/usage.html#usage-with-the-pre-commit-git-hooks-framework
• xr.Dataset instead of xarray object
• rm @is_xarray
• check missing
• unify docstrings Unify docstrings #657
• hind->initialized
• reduce warnings in make html
• link to xclim docs
• reference section *
• typing, no str, list of str
• defaults
• format return
• Metrics code like comparison
• Notebooks other PR
• Crps second example

Closes #707 #typing

To-Do List

Type of change

• Improved Documentation

[codecov]

Codecov Report

Merging #708 (1b5ebec) into main (5e01fdb) will decrease coverage by 0.13%.
The diff coverage is 94.40%.

@@            Coverage Diff             @@
##             main     #708      +/-   ##
==========================================
- Coverage   93.99%   93.85%   -0.14%     
==========================================
  Files          59       59              
  Lines        6390     6253     -137     
==========================================
- Hits         6006     5869     -137     
  Misses        384      384              

Impacted Files	Coverage Δ
climpred/classes.py	94.05% <ø> (-0.20%)	⬇️
climpred/conftest.py	97.97% <ø> (ø)
climpred/constants.py	100.00% <ø> (ø)
climpred/logging.py	100.00% <ø> (ø)
climpred/metrics.py	91.73% <ø> (-0.05%)	⬇️
climpred/options.py	81.48% <ø> (ø)
climpred/tests/test_PredictionEnsemble.py	100.00% <ø> (ø)
climpred/tests/test_checks.py	100.00% <ø> (+0.78%)	⬆️
climpred/tests/test_compute_dims.py	100.00% <ø> (ø)
climpred/tests/test_graphics.py	100.00% <ø> (ø)
... and 28 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 5e01fdb...1b5ebec. Read the comment docs.