Enhanced documentation including docstrings

Author: forman

docs/cli.md

@@ -1,11 +1,15 @@
 # Command Line Interface Reference
 
-
-
 ```
 Usage: zappend [OPTIONS] [SLICES]...
 
-  Create or update a Zarr dataset TARGET from slice datasets SLICES.
+  Create or update a Zarr datacube TARGET from slice datasets SLICES.
+
+  The zappend command concatenates the dataset SLICES along a given append
+  dimension, e.g., `"time"` (the default) for geospatial satellite
+  observations. Each append step is atomic, that is, the append operation is a
+  transaction that can be rolled back, in case the append operation fails.
+  This ensures integrity of the target data cube given by TARGET or in CONFIG.
 
 Options:
   -c, --config CONFIG    Configuration JSON or YAML file. If multiple are

zappend/api.py

@@ -38,8 +38,9 @@ def zappend(
     """
     Robustly create or update a Zarr dataset from dataset slices.
 
-    It concatenates the dataset slices from given `slices` along a given append
-    dimension, e.g., `"time"` (the default) for geospatial satellite observations.
+    The `zappend` function concatenates the dataset slices from given `slices` along a
+    given append dimension, e.g., `"time"` (the default) for geospatial satellite
+    observations.
     Each append step is atomic, that is, the append operation is a transaction
     that can be rolled back, in case the append operation fails.
     This ensures integrity of the  target data cube `target_dir` given in `config`

zappend/cli.py

@@ -43,11 +43,11 @@ def zappend(
 ):
     """Create or update a Zarr datacube TARGET from slice datasets SLICES.
 
-    It concatenates the dataset SLICES along a given append dimension, e.g., `"time"`
-    (the default) for geospatial satellite observations. Each append step is atomic,
-    that is, the append operation is a transaction that can be rolled back, in case
-    the append operation fails. This ensures integrity of the target data cube given
-    by TARGET or in CONFIG.
+    The zappend command concatenates the dataset SLICES along a given append dimension,
+    e.g., `"time"` (the default) for geospatial satellite observations.
+    Each append step is atomic, that is, the append operation is a transaction that can
+    be rolled back, in case the append operation fails. This ensures integrity of the
+    target data cube given by TARGET or in CONFIG.
     """
 
     if help_config: