@@ -0,0 +1,26 @@
+ci:
+  autoupdate_schedule: quarterly
+  autofix_prs: false
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-yaml
+      - id: check-toml
+        exclude: "^template/"
+      - id: check-json
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: end-of-file-fixer
+        exclude: ".*\\.ipynb$"
+      - id: trailing-whitespace
+        exclude: ".*\\.ipynb$"
+      - id: mixed-line-ending
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff
+        args: ["--fix", "--exit-non-zero-on-fix"]
+        exclude: "^template/"
@@ -78,10 +78,9 @@ available:
 Not every service supports every operation for every collection; check first:
 
 ```python
-ea.plugins.harmony.capabilities("MUR-JPL-L4-GLOB-v4.1")
-# operations: reproject, subset_bbox, subset_dimension, subset_shape,
-#             subset_temporal, subset_variable
-# formats: application/netcdf, image/jpeg, image/png, image/tiff
+caps = ea.plugins.harmony.capabilities("MUR-JPL-L4-GLOB-v4.1")
+print(caps)         # one summary line per operation
+caps.explain()      # options, output kinds and an example for each
 ```
 
 Example — subset, reproject to a polar grid and return a GeoTIFF:
@@ -145,9 +144,12 @@ service:
 
 ```python
 ea.plugins.harmony.capabilities(results)
-# Capabilities('harmony supported ATL06', operations=3)
-#   operations: subset_bbox, subset_temporal, subset_variable
-#   formats: application/netcdf4
+# harmony supported ATL06
+#   subset_bbox      restrict the result to a spatial extent (bbox or wkt)
+#   subset_temporal  restrict the result to a time interval (temporal)
+#   subset_variable  select a subset of variables; an unknown name raises
+#   formats: netcdf4
+#   hint: use .explain() for options and examples
 
 ea.plugins.harmony.capabilities("ATL06")  # by short name
 ```