diff --git a/docs/app/otsu/app.md b/docs/app/otsu/app.md
index 27a89d0..b386729 100644
--- a/docs/app/otsu/app.md
+++ b/docs/app/otsu/app.md
@@ -1,3 +1,9 @@
+### Step purpose 
+
+Purpose: to apply the Otsu threshold to the normalized difference. 
+
+### Code
+
 The `otsu` Python script is a command-line tool for applying the Otsu threshold to a single input raster image. 
 
 It uses the `click`, `rasterio`, `numpy`, `skimage.filters`, and `loguru` libraries.
@@ -30,6 +36,7 @@ Options:
   --help  Show this message and exit.
 ```
 
+The Python code is provided here:
 
 ```python linenums="1" title="water-bodies/command-line-tools/otsu/app.py"
 --8<--
diff --git a/docs/app/stac/app.md b/docs/app/stac/app.md
index 1475190..6470637 100644
--- a/docs/app/stac/app.md
+++ b/docs/app/stac/app.md
@@ -1,3 +1,10 @@
+### Step purpose 
+
+Purpose: produce a STAC Catalog with a STAC Item describing the detected water body result. 
+
+### Code
+
+
 The `stac` script is a command-line tool for creating a SpatioTemporal Asset Catalog (STAC) catalog containing detected water bodies.
 
 It takes the STAC Item URLs and corresponding water body GeoTIFFs as input, creates STAC Items for each water body, and organizes them into a STAC Catalog. 
@@ -33,7 +40,7 @@ Options:
   --help             Show this message and exit.
 ```
 
-
+The Python code is provided here:
 
 ```python linenums="1" title="water-bodies/command-line-tools/stac/app.py"
 --8<--