diff --git a/River-Editor.asciidoc b/River-Editor.asciidoc
new file mode 100644
index 0000000..309605d
--- /dev/null
+++ b/River-Editor.asciidoc
@@ -0,0 +1,18 @@
+*River Editor* is aimed to individually edit existing river or create a new river. To open the Editor click on any river.
+
+Buttons:
+
+* Risize () - ability to rotate and re-scale the river, it may be a bit buggy, please use wisely
+ 
+* Renegerate () - regenerate river based on main points, the river width will be randomized so the button could be also used to change the river width
+
+* Add point (+) - click on the map to add new river point and re-draw a river. 
+
+* Remove point (-) - click on a river point to remove it and re-draw a river
+
+* Copy () - copy river and place near the selected one
+
+* Remove () - remove the river (the action cannot be canceled)
+
+* New River (+) - click on the map to create a new river and define a river course. Click on added point or river course to finish the river creation 
+