Generate etl graphs

Makefile

@@ -8,37 +8,37 @@ poi.md: openmaptiles
 	generate-doc openmaptiles/layers/poi/poi.yaml --diagram poi > poi.md
 
 highway.md: openmaptiles
-	generate-doc openmaptiles/layers/highway/highway.yaml --diagram highway > highway.md
+	generate-doc openmaptiles/layers/highway/highway.yaml --diagram highway > highway.md && generate-etlgraph openmaptiles/layers/highway/highway.yaml && dot -Tpng openmaptiles/layers/highway/etl_highway.dot -o etl_highway.png
 
 highway_name.md: openmaptiles
 	generate-doc openmaptiles/layers/highway_name/highway_name.yaml  > highway_name.md
 
 railway.md: openmaptiles
-	generate-doc openmaptiles/layers/railway/railway.yaml --diagram railway > railway.md
+	generate-doc openmaptiles/layers/railway/railway.yaml --diagram railway > railway.md && generate-etlgraph openmaptiles/layers/railway/railway.yaml && dot -Tpng openmaptiles/layers/railway/etl_railway.dot -o etl_railway.png
 
 boundary.md: openmaptiles
-	generate-doc openmaptiles/layers/boundary/boundary.yaml --diagram boundary > boundary.md
+	generate-doc openmaptiles/layers/boundary/boundary.yaml --diagram boundary > boundary.md && generate-etlgraph openmaptiles/layers/boundary/boundary.yaml && dot -Tpng openmaptiles/layers/boundary/etl_boundary.dot -o etl_boundary.png
 
 water_name.md: openmaptiles
-	generate-doc openmaptiles/layers/water_name/water_name.yaml  > water_name.md
+	generate-doc openmaptiles/layers/water_name/water_name.yaml --diagram water_name > water_name.md && generate-etlgraph openmaptiles/layers/water_name/water_name.yaml && dot -Tpng openmaptiles/layers/water_name/etl_water_name.dot -o etl_water_name.png
 
 water.md: openmaptiles
-	generate-doc openmaptiles/layers/water/water.yaml --diagram water > water.md
+	generate-doc openmaptiles/layers/water/water.yaml --diagram water > water.md && generate-etlgraph openmaptiles/layers/water/water.yaml && dot -Tpng openmaptiles/layers/water/etl_water.dot -o etl_water.png
 
 waterway.md: openmaptiles
-	generate-doc openmaptiles/layers/waterway/waterway.yaml --diagram waterway > waterway.md
+	generate-doc openmaptiles/layers/waterway/waterway.yaml --diagram waterway > waterway.md && generate-etlgraph openmaptiles/layers/waterway/waterway.yaml && dot -Tpng openmaptiles/layers/waterway/etl_waterway.dot -o etl_waterway.png
 
 building.md: openmaptiles
-	generate-doc openmaptiles/layers/building/building.yaml  > building.md
+	generate-doc openmaptiles/layers/building/building.yaml --diagram building > building.md && generate-etlgraph openmaptiles/layers/building/building.yaml && dot -Tpng openmaptiles/layers/building/etl_building.dot -o etl_building.png
 
 place.md: openmaptiles
-	generate-doc openmaptiles/layers/place/place.yaml --diagram place > place.md
+	generate-doc openmaptiles/layers/place/place.yaml --diagram place > place.md && generate-etlgraph openmaptiles/layers/place/place.yaml && dot -Tpng openmaptiles/layers/place/etl_place.dot -o etl_place.png
 
 landuse.md: openmaptiles
-	generate-doc openmaptiles/layers/landuse/landuse.yaml --diagram landuse > landuse.md
+	generate-doc openmaptiles/layers/landuse/landuse.yaml --diagram landuse > landuse.md && generate-etlgraph openmaptiles/layers/landuse/landuse.yaml && dot -Tpng openmaptiles/layers/landuse/etl_landuse.dot -o etl_landuse.png
 
 landcover.md: openmaptiles
-	generate-doc openmaptiles/layers/landcover/landcover.yaml --diagram landcover > landcover.md
+	generate-doc openmaptiles/layers/landcover/landcover.yaml --diagram landcover > landcover.md && generate-etlgraph openmaptiles/layers/landcover/landcover.yaml && dot -Tpng openmaptiles/layers/landcover/etl_landcover.dot -o etl_landcover.png
 
 housenumber.md: openmaptiles
-	generate-doc openmaptiles/layers/housenumber/housenumber.yaml  > housenumber.md
+	generate-doc openmaptiles/layers/housenumber/housenumber.yaml > housenumber.md && generate-etlgraph openmaptiles/layers/housenumber/housenumber.yaml && dot -Tpng openmaptiles/layers/housenumber/etl_housenumber.dot -o etl_housenumber.png

building.md

@@ -8,5 +8,8 @@ this is welcomed.
 - **render_min_height**: An approximated height from levels and height of the bottom of the building or building:part after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear). For future 3D rendering of buildings.
 - **render_height**: An approximated height from levels and height of the building or building:part after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear). For future 3D rendering of buildings.
 
+## Mapping
+
+![](building.png)
 
 

railway.md

@@ -0,0 +1,19 @@
+# railway
+
+The `railway` layer contains linestrings marking tracks from [OSM Railways](http://wiki.openstreetmap.org/wiki/Railways).
+It contains tracks for [passenger and freight trains]() and smaller tracks for [Trams](http://wiki.openstreetmap.org/wiki/Tag:railway%3Dtram) or [similar](http://wiki.openstreetmap.org/wiki/Tag:railway%3Dlight_rail) vehicles. But also tracks for [subways](http://wiki.openstreetmap.org/wiki/Tag:railway%3Dsubway), [narrow-gauge trains](http://wiki.openstreetmap.org/wiki/Tag:railway%3Dnarrow_gauge) or [historic trains](http://wiki.openstreetmap.org/wiki/Tag:railway%3Dpreserved).
+Non mainline tracks (marked with class `minor_rail`) used for [storage of trains](http://wiki.openstreetmap.org/wiki/Tag:service%3Dyard) and [maintenance](http://wiki.openstreetmap.org/wiki/Tag:service%3Dsiding) are contained in the highest zoom levels and should be styled more subtle than the mainline tracks with class `rail`.
+
+## Fields
+
+- **class**: Divides the track into mainline tracks (class `rail`) and less important tracks
+used for maintenance (class `minor_rail`).
+- **subclass**: Original value of the [`railway`](http://wiki.openstreetmap.org/wiki/Key:railway) can be one of
+`rail`, `light_rail`, `subway`, `narrow_gauge`, `preserved`, `tram`.
+- **properties**: Additional properties describing the nature of tracks. Can be either `bridge` or `tunnel`.
+
+## Mapping
+
+![](railway.png)
+
+

water_name.md

@@ -10,5 +10,8 @@ which derives nice centerlines from OSM water bodies. Only the most important la
 - **name**: The OSM [`name`](http://wiki.openstreetmap.org/wiki/Key:name) value of the water body.
 - **class**: At the moment only `lake` since no ocean parts are labelled. *Reserved for future use*.
 
+## Mapping
+
+![](water_name.png)