diff --git a/Tools/Scripts/README.md b/Tools/Scripts/README.md
index 98e039a..07c8662 100644
--- a/Tools/Scripts/README.md
+++ b/Tools/Scripts/README.md
@@ -128,6 +128,15 @@ Generates the entire 2D blueprint. Roughly in order:
    re-captured after the river pass so the exported PNGs show them). Max-cut is now reported
    CUMULATIVELY vs the pre-pass surface.
 
+   **Polish (task 24)** — tributaries carry water too, gated by along-course flow
+   (`RiverTribWaterMinFlow`, 0 = water them end to end) and **tapered** at the wet→dry
+   transition over `RiverTribTaperPx`: the strip narrows and its surface drops to the bed, so a
+   stream head fades instead of ending in a wall of water. Lake-enders route to the nearest
+   **significant** water body (`RiverLakeMinTargetPx`, 20k cells) — "nearest wet cell" was
+   satisfied by a 322-px puddle beside a 197k-px lagoon. Steps are finer (`RiverStepDropM` 0.6 m)
+   and beds deeper (`RiverDepthScale` 1.5, `RiverWaterDepthM` 2.2 m) so the chain reads as a graded
+   descent rather than a pond staircase: 1034 reaches, adjacent-reach level gaps median 0.12 m.
+
 3. **Sea level and water** — sea level per the configured model (`SeaLevelModel`: `"flat"` scalar
    — the default, `SeaLevelValue` 0.15 — or the legacy `"field"` latitude Lerp); flood fill
    separates true ocean from inland lakes; a mainland fill guarantees one contiguous landmass.