diff --git a/layers/mountain_peak/README.md b/layers/mountain_peak/README.md
new file mode 100644
index 0000000..91cba6f
--- /dev/null
+++ b/layers/mountain_peak/README.md
@@ -0,0 +1,7 @@
+## Mountain Peaks
+
+### Mapping Diagram
+![Mapping diagram for mountain peaks](etl_diagram.png?raw=true)
+
+### ETL diagram
+![ETL diagram for mountain peaks](mapping_diagram.png?raw=true)
diff --git a/layers/mountain_peak/etl_diagram.png b/layers/mountain_peak/etl_diagram.png
new file mode 100644
index 0000000..4b89788
Binary files /dev/null and b/layers/mountain_peak/etl_diagram.png differ
diff --git a/layers/mountain_peak/layer.sql b/layers/mountain_peak/layer.sql
index e150a5c..4c6b6c8 100644
--- a/layers/mountain_peak/layer.sql
+++ b/layers/mountain_peak/layer.sql
@@ -1,6 +1,10 @@
+
+-- etldoc: layer_mountain_peak[shape=record fillcolor=lightpink,
+-- etldoc:     style="rounded,filled", label="layer_mountain_peak | <z7_> z7+" ] ;
+
 CREATE OR REPLACE FUNCTION layer_mountain_peak(bbox geometry, zoom_level integer, pixel_width numeric)
 RETURNS TABLE(osm_id bigint, geometry geometry, name text, name_en text, ele int, ele_ft int, "rank" int) AS $$
-   -- etldoc: osm_housenumber_point -> layer_housenumber:z14_
+   -- etldoc: osm_peak_point -> layer_mountain_peak:z7_
    SELECT osm_id, geometry, name, name_en, ele::int, ele_ft::int, rank::int
    FROM (
      SELECT osm_id, geometry, name, name_en,
diff --git a/layers/mountain_peak/mapping.yaml b/layers/mountain_peak/mapping.yaml
index ea2fed4..ae63950 100644
--- a/layers/mountain_peak/mapping.yaml
+++ b/layers/mountain_peak/mapping.yaml
@@ -1,7 +1,7 @@
 
 tables:
 
-  # etldoc: imposm3 -> osm_housenumber_point
+  # etldoc: imposm3 -> osm_peak_point
   peak_point:
     type: point
     fields:
diff --git a/layers/mountain_peak/mapping_diagram.png b/layers/mountain_peak/mapping_diagram.png
new file mode 100644
index 0000000..842b8f5
Binary files /dev/null and b/layers/mountain_peak/mapping_diagram.png differ
diff --git a/layers/mountain_peak/mountain_peak.yaml b/layers/mountain_peak/mountain_peak.yaml
index de64889..c1932f5 100644
--- a/layers/mountain_peak/mountain_peak.yaml
+++ b/layers/mountain_peak/mountain_peak.yaml
@@ -1,8 +1,7 @@
 layer:
   id: "mountain_peak"
   description: |
-      [Peaks](http://wiki.openstreetmap.org/wiki/Tag:natural%3Dpeak)
-      or [volcanoes](http://wiki.openstreetmap.org/wiki/Tag:natural%3Dvolcano)
+      [Natural peaks](http://wiki.openstreetmap.org/wiki/Tag:natural%3Dpeak)
   buffer_size: 64
   srs: +proj=merc +a=6378137 +b=6378137 +lat_ts=0.0 +lon_0=0.0 +x_0=0.0 +y_0=0.0 +k=1.0 +units=m +nadgrids=@null +wktext +no_defs +over
   fields: