Merge pull request #17 from ecmwf/main

Update docs

.pre-commit-config.yaml

@@ -15,7 +15,7 @@ repos:
   hooks:
   - id: isort
 - repo: https://github.com/psf/black
-  rev: 23.3.0
+  rev: 23.9.1
   hooks:
   - id: black
 - repo: https://github.com/keewis/blackdoc
@@ -33,13 +33,12 @@ repos:
   - id: mdformat
     exclude: cruft-update-template.md
 - repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
-  rev: v2.4.0
+  rev: v2.11.0
   hooks:
   - id: pretty-format-yaml
     args: [--autofix, --preserve-quotes]
   - id: pretty-format-toml
     args: [--autofix]
-    additional_dependencies: [toml-sort<0.22.0]
 - repo: https://github.com/PyCQA/pydocstyle.git
   rev: 6.1.1
   hooks:

docs/install.rst

@@ -14,13 +14,13 @@ Install **earthkit** with python3 (>= 3.8) and ``pip`` as follows:
 
     python3 -m pip install earthkit
 
-Alternatively, install via ``conda`` with:
+.. Alternatively, install via ``conda`` with:
 
-.. code-block:: bash
+.. .. code-block:: bash
 
-    conda install earthkit -c conda-forge
+..     conda install earthkit -c conda-forge
 
-This will bring in some necessary binary dependencies for you.
+.. This will bring in some necessary binary dependencies for you.
 
 Installing the binary dependencies
 --------------------------------------

pyproject.toml

@@ -8,8 +8,8 @@ branch = true
 profile = "black"
 
 [tool.pydocstyle]
-convention = "numpy"
 add_ignore = ["D1", "D200", "D205", "D400", "D401"]
+convention = "numpy"
 
 [tool.setuptools_scm]
 write_to = "earthkit/version.py"