initial commit from prototype

README.md

@@ -1,9 +1,29 @@
 # advanced_erosion_terrain_heightmap_generation
 
-A krita plugin designed to implement Runevision's (Skovbo Johansen) fast erosion filter on top of noise for realistic looking terrain.
+A krita plugin designed to implement Runevision's (Skovbo Johansen) fast erosion filter on top of noise for realistic looking terrain.
+
+See here:
 
-See here:
-
-https://www.shadertoy.com/view/wXcfWn
-https://www.shadertoy.com/view/sf23W1
-https://blog.runevision.com/2026/03/fast-and-gorgeous-erosion-filter.html
+https://www.shadertoy.com/view/wXcfWn
+https://www.shadertoy.com/view/sf23W1
+https://blog.runevision.com/2026/03/fast-and-gorgeous-erosion-filter.html
+
+## Plugin layout
+
+The production Krita plugin lives under `pykrita/advanced_erosion_generator/`.
+The `tests/` directory remains prototype-only reference code and is not imported by the plugin.
+
+## Installing in Krita
+
+Copy `pykrita/advanced_erosion_generator.desktop` and the `pykrita/advanced_erosion_generator/` folder into Krita's `pykrita` directory.
+
+## Current UI
+
+The plugin adds `Tools > Scripts > Generate Advanced Erosion Terrain` and uses the active document resolution as the terrain output size.
+
+Controls:
+
+- Generation Scale
+- Erosion Scale
+- Random Seed with a randomize button
+- Advanced dropdown with Strength, Gully Weight, Detail, and Octaves