update intro text

Author: forman

README.md

@@ -19,43 +19,51 @@
 
 ---
 
-`zappend` is a tool written in Python that is used for robustly creating and updating 
-Zarr datacubes from smaller dataset slices. It is built on top of the awesome Python
-packages [xarray](https://docs.xarray.dev/) and [zarr](https://zarr.readthedocs.io/).
+`zappend` is a tool written in Python that is used for robustly creating and 
+updating Zarr datacubes from smaller dataset slices. It is built on top of the 
+awesome Python packages [xarray](https://docs.xarray.dev/) and [zarr](https://zarr.readthedocs.io/).
 
 ## Motivation
 
-The objective of `zappend` is to address recurring memory issues when generating large 
-geospatial datacubes using the [Zarr format](https://zarr.readthedocs.io/en/stable/spec/v2.html) 
-by subsequently concatenating data slices along an 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. 
+The objective of `zappend` is empowering geodata scientists and developers to 
+robustly create large data cubes. The tool performs transaction-based dataset 
+appends to existing data cubes in the 
+[Zarr format](https://zarr.readthedocs.io/en/stable/spec/v2.html). If an error 
+occurs during an append step — typically due to I/O problems or out-of-memory 
+conditions — `zappend` will automatically roll back the operation, ensuring that 
+the existing data cube maintains its structural integrity. The design drivers 
+behind zappend are first ease of use and secondly, high configurability 
+regarding filesystems, data source types, data cube outline and encoding. 
+
+The tool comprises a command-line interface, a Python API for programmatic 
+control, and a comprehensible documentation to guide users effectively. 
+You can easily install `zappend` as a plain Python package using either 
+`pip install zappend` or `conda install -conda-forge zappend`.
 
 ## Features
 
 The `zappend` tool provides the following features:
 
-* **Locking**: While the target dataset is being modified, a file lock is created, 
-  effectively preventing concurrent dataset modifications.
+* **Locking**: While the target dataset is being modified, a file lock is 
+  created, effectively preventing concurrent dataset modifications.
 * **Transaction-based dataset appends**: On failure during an append step, 
   the transaction is rolled back, so that the target dataset remains valid and 
   preserves its integrity.
-* **Filesystem transparency**: The target dataset may be generated and updated in 
-  any writable filesystems supported by the 
+* **Filesystem transparency**: The target dataset may be generated and updated 
+  in any writable filesystems supported by the 
   [fsspec](https://filesystem-spec.readthedocs.io/) package. 
   The same holds for the slice datasets to be appended.
 * **Dataset polling**: The tool can be configured to wait for slice datasets to 
   become available. 
-* **CLI and Python API**: The tool can be used in a shell using the [`zappend`](cli.md)
-  command or from Python. When used from Python using the 
-  [`zappend()`](api.md) function, slice datasets can be passed as local file paths, 
-  URIs, as datasets of type 
+* **Dynamic attributes**: Use syntax `{{ expression }}` to update the target 
+  dataset with dynamically computed attribute values. 
+* **CLI and Python API**: The tool can be used in a shell using the 
+  [`zappend`](cli.md) command or from Python. When used from Python using the 
+  [`zappend()`](api.md) function, slice datasets can be passed as local file 
+  paths, URIs, as datasets of type 
   [xarray.Dataset](https://docs.xarray.dev/en/stable/generated/xarray.Dataset.html), or as custom 
   [zappend.api.SliceSource](https://bcdev.github.io/zappend/api/#class-slicesource) objects.
 
-
-
+  
 More about zappend can be found in its 
 [documentation](https://bcdev.github.io/zappend/).

docs/index.md

@@ -1,40 +1,44 @@
 <!--- Align following section with README.md -->
 
-# The zappend Tool
+# zappend Documentation
 
-`zappend` is a tool written in Python that is used for robustly creating and updating 
-Zarr datacubes from smaller dataset slices. It is built on top of the awesome Python
-packages [xarray](https://docs.xarray.dev/) and [zarr](https://zarr.readthedocs.io/).
+`zappend` is a tool written in Python that is used for robustly creating and 
+updating Zarr datacubes from smaller dataset slices. It is built on top of the 
+awesome Python packages [xarray](https://docs.xarray.dev/) and [zarr](https://zarr.readthedocs.io/).
 
 ## Motivation
 
-The objective of `zappend` is to address recurring memory issues when generating large 
-geospatial datacubes using the [Zarr format](https://zarr.readthedocs.io/en/stable/spec/v2.html) 
-by subsequently concatenating data slices along an 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. 
+The objective of `zappend` is empowering geodata scientists and developers to 
+robustly create large data cubes. The tool performs transaction-based dataset 
+appends to existing data cubes in the 
+[Zarr format](https://zarr.readthedocs.io/en/stable/spec/v2.html). If an error 
+occurs during an append step — typically due to I/O problems or out-of-memory 
+conditions — `zappend` will automatically roll back the operation, ensuring that 
+the existing data cube maintains its structural integrity. The design drivers 
+behind zappend are first ease of use and secondly, high configurability 
+regarding filesystems, data source types, data cube outline and encoding. 
 
 ## Features
 
 The `zappend` tool provides the following features:
 
-* **Locking**: While the target dataset is being modified, a file lock is created, 
-  effectively preventing concurrent dataset modifications.
+* **Locking**: While the target dataset is being modified, a file lock is 
+  created, effectively preventing concurrent dataset modifications.
 * **Transaction-based dataset appends**: On failure during an append step, 
   the transaction is rolled back, so that the target dataset remains valid and 
   preserves its integrity.
-* **Filesystem transparency**: The target dataset may be generated and updated in 
-  any writable filesystems supported by the 
+* **Filesystem transparency**: The target dataset may be generated and updated 
+  in any writable filesystems supported by the 
   [fsspec](https://filesystem-spec.readthedocs.io/) package. 
   The same holds for the slice datasets to be appended.
 * **Dataset polling**: The tool can be configured to wait for slice datasets to 
   become available. 
-* **CLI and Python API**: The tool can be used in a shell using the [`zappend`](cli.md)
-  command or from Python. When used from Python using the 
-  [`zappend()`](api.md) function, slice datasets can be passed as local file paths, 
-  URIs, as datasets of type 
+* **Dynamic attributes**: Use syntax `{{ expression }}` to update the target 
+  dataset with dynamically computed attribute values. 
+* **CLI and Python API**: The tool can be used in a shell using the 
+  [`zappend`](cli.md) command or from Python. When used from Python using the 
+  [`zappend()`](api.md) function, slice datasets can be passed as local file 
+  paths, URIs, as datasets of type 
   [xarray.Dataset](https://docs.xarray.dev/en/stable/generated/xarray.Dataset.html), or as custom 
   [zappend.api.SliceSource](https://bcdev.github.io/zappend/api/#class-slicesource) objects.
 

setup.cfg

@@ -7,7 +7,7 @@ long_description = file: README.md
 long_description_content_type = text/markdown
 keywords = analysis ready data, data science, datacube, xarray, zarr
 license = MIT
-url = https://bcdev.github.io/zappend
+url = https://github.com/bcdev/zappend
 project_urls =
 	Documentation = https://bcdev.github.io/zappend/
 	Issues = https://github.com/bcdev/zappend/issues