Feature/merge 1.0.0rc0 into develop

.gitignore

@@ -209,15 +209,19 @@ instance/
 
 # Sphinx documentation
 docs/_build/
-docs/examples/*.tar
-docs/examples/*.zip
-docs/examples/_*
-docs/examples/earthkit_use_cases/*.grib
-docs/examples/_fdb
-docs/experimental/_*
-docs/experimental/*.grib*
-docs/experimental/*.pp*
-docs/experimental/*.png*
+docs/source/how-tos/*.tar
+docs/source/how-tos/*.zip
+docs/source/how-tos/_*
+docs/source/how-tos/earthkit_use_cases/*.grib
+docs/source/how-tos/*/_*
+docs/source/experimental/_*
+docs/source/experimental/*.grib*
+docs/source/experimental/*.pp*
+docs/source/experimental/*.png*
+docs/source/experimental/*.nc*
+docs/source/experimental/*.geojson*
+
+autodocs/
 
 # PyBuilder
 .pybuilder/

.pre-commit-config.yaml

@@ -18,7 +18,7 @@ repos:
   rev: v0.15.4
   hooks:
   - id: ruff-check
-    exclude: '(dev/.*|.*_)\.py$'
+    exclude: '(dev/.*|.*_)\.py$|docs/source/experimental/.*\.ipynb$|polytope_feature\.ipynb$|field_overview\.ipynb$'
     args:
     - --fix
     - --exit-non-zero-on-fix

.readthedocs.yml

@@ -1,13 +1,40 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
 version: 2
-formats: []
+
+# Set the OS, Python version and other tools you might need
 build:
-  os: "ubuntu-22.04"
+  os: ubuntu-22.04
   tools:
-    python: "3.10"
+    python: "3.11"
+  jobs:
+    pre_build:
+    - rm -rf _build
+    - rm -rf docs/_build
+    - cd docs
+    # You can also specify other tool versions:
+    # nodejs: "19"
+    # rust: "1.64"
+    # golang: "1.19"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/source/conf.py
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#    - pdf
+#    - epub
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
 python:
   install:
-  - requirements: docs/requirements.txt
   - method: pip
     path: .
-sphinx:
-  configuration: docs/conf.py
+    extra_requirements:
+    - docs

docs/Makefile

@@ -5,7 +5,7 @@
 # from the environment for the first two.
 SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = .
+SOURCEDIR     = source
 BUILDDIR      = _build
 
 # Put it first so that "make" without argument is like "make help".