improve docs

.pre-commit-config.yaml

@@ -29,9 +29,9 @@ repos:
       hooks:
       -   id: isort
 
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v0.910-1
-    hooks:
+  -   repo: https://github.com/pre-commit/mirrors-mypy
+      rev: v0.910-1
+      hooks:
       - id: mypy
         exclude: "asv_bench"
         additional_dependencies: [
@@ -44,3 +44,16 @@ repos:
             # Dependencies that are typed
             numpy,
           ]
+
+  -   repo: https://github.com/pycqa/pydocstyle
+      rev: 6.1.1
+      hooks:
+      -   id: pydocstyle
+      args:
+      - --ignore=W503
+      - --max-line-length=93
+
+  -   repo: https://github.com/pycqa/doc8
+      rev: 0.10.1
+      hooks:
+      -   id: doc8

CHANGELOG.rst

@@ -13,6 +13,7 @@ What's New
     # cut border when saving (for maps)
     mpl.rcParams["savefig.bbox"] = "tight"
 
+
 climpred unreleased (202x-xx-xx)
 ================================