diff --git a/Heightmap-customization.md b/Heightmap-customization.md
index 5b6574f..6dfdb0f 100644
--- a/Heightmap-customization.md
+++ b/Heightmap-customization.md
@@ -1,42 +1,50 @@
-*Heightmap customization* is a process of a Heightmap creation controlled by user in opposite to a random generation. There are 4 main customization flows available:
+*Heightmap customization* is a process of Heightmap creation controlled by user in opposite to a random generation. There are 4 main customization flows available:
-* _draw_ heightmap from scratch
-* apply existing _heightmap template_
-* create new _heightmap template_
-* _convert_ image into a heightmap.
+* _draw_ Heightmap from scratch
+* apply existing _Heightmap template_
+* create new _Heightmap template_
+* _convert_ image into a Heightmap.
I would recommend to set up a template or convert image as a first step and then use _free draw_ tools to fine tune a Heightmap.
-To start customization click on the arrow button to open the Options. Open _Customize_ tab and click on Heightmap. Click on Clear all button to remove the existing map and generate a new Voronoi diagram or Roll back to degrade a completed map (even a loaded one) to a heightmap.
+To start customization click on the arrow button to open the Menu. Open the _Tools_ tab and click on Heightmap.
+Click on:
+* the Erase button to remove everything except the Heightmap and edit the pure Heightmap.
+* the Keep button to keep all data assigned to every cell and edit only the landmass without changing the coastline.
+* the Risk button to keep all data assigned to every cell and edit the whole Heightmap*.
+* the Cancel button to aboard changing the Heightmap.
+
+/*Like the button says the Risk option is risky and can cause a lot of trouble. Use this option only if you know what you are doing and maybe save before using it.
* To _draw_ a map click on Paint Brushes
* To apply or edit template click on Template Editor
* To convert image click on Image Converter
-* To see a semi-3d heightmap view click on Perspective View
+* To see a b/w preview of your Heightmap click on Heightmap Preview
+* To see a semi-3d Heightmap view click on Perspective View
-Once you are satisfied with the Heightmap, click on Complete. To minimize the failure risk the button activates only where there are at least some land cells.
+Once you are satisfied with the Heightmap, click on Exit Customization. To minimize the failure risk the button activates only where there are at least 200 land cells.
## Paint brushes
-* Brush height (H; left slider) - slider to control Height value for brushes below
-* Brush radius (R; right slider) - slider to control Radius for non-feature brushes
-* Hill H - a round blob, drag the map for continuous placement
-* Pit P - a round depression, drag the map for continuous placement
-* Range R - an elongated blob, click once to set a start point, the second click to place a Range
-* Trough T - an elongated depression, click once to set a start point, the second click to place a Trough
-* Elevate ↥ - increase cell height, drag the map for continuous usage
-* Depress ↧ - decrease cell height, drag the map for continuous usage
-* Align = - fit cell's height to the first tagged cell, drag the map for continuous usage
+* Radius (top slider) - slider to control Radius for brushes
+* Power (bottom slider) - slider to control the intensity of brushes
+* Raise ⤒ - increase cell height by power value, drag for continuous usage
+* Elevate  - drag to gradually increase cell height by power value
+* Lower ⤓ - decrease cell height by power value, drag for continuous usage
+* Depress  - drag to gradually decrease cell height
+* Align = - fit cell's height to the first tagged cell, drag for continuous usage
* Smooth ~ - smooth cell height, drag the map for continuous usage
+* Disrupt  - randomize heights a bit, drag for continuous usage
+* Checkbox “_change only land cells_” - this option allows you to prevent you from changing the coastline
### Footer buttons:
* Un-do ↺ - step back, works only for a Heightmap customization
* Re-do ↻ - step forward, works only for a Heightmap customization
* Rescaler ⇄ - slider to rescale all cells
* Condition _if_ - conditional Height rescaler
-* Discrupt ෴ - randomize all heights a bit
-* Smooth ~ - smooth all heights
-* Clear ⌫ - clear the map
+* Smooth ~ - smooth all heights a bit
+* Disrupt ෴ - randomize all heights a bit
+* Clear  - set all heights to 0
## Template Editor
@@ -45,4 +53,26 @@ Description is not ready. To be updated...
## Image Converter
-Description is not ready. To be updated...
\ No newline at end of file
+*  - Upload image
+ * Here you can upload the image you’d like to convert into a Heightmap.
+ * You can upload colored or b/w images.
+ * Recommended are b/w images with black beeing ocean
+* ◑ - Auto-assign colors based on luminosity
+ * This option assigns the colors to heights based on their luminosity.
+*  - Auto-assign colors based on hue
+ * This option assigns the colors to heights based on their hue.
+*  - Reduce the number of colors
+ * Here you can reduce the number of colors of the image.
+ * This obviously reduces the number of heights to assign.
+ * The minimal number is 3.
+
+*  - Increase the number of colors
+ * Here you can increase the number of colors of the image.
+ * This also increases the number of heights to assign.
+ * The maximal number is 256.
+* 🗹 - Complete the assignment
+ * This completes the assignment of colors.
+ * All not assigned colors will be considered an ocean.
+
+You also can assign the colors by hand.
+To do so click on a color and then select a height by clicking on the bar above.