Document water_name and waterway

layers/water_name/README.md

@@ -0,0 +1,14 @@
+# water_name
+
+Lake center lines for labelling lake bodies.
+This is based of the [osm-lakelines](https://github.com/lukasmartinelli/osm-lakelines) project
+which derives nice centerlines from OSM water bodies. Only the most important lakes contain labels.
+
+## Fields
+
+- **name_en**: The english `name:en` value if available.
+- **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*.
+
+
+

layers/water_name/water_name.yaml

@@ -1,11 +1,16 @@
 layer:
   id: "water_name"
   description: |
-      OSM lakelines.
+      Lake center lines for labelling lake bodies.
+      This is based of the [osm-lakelines](https://github.com/lukasmartinelli/osm-lakelines) project
+      which derives nice centerlines from OSM water bodies. Only the most important lakes contain labels.
+  fields:
+    name: The OSM [`name`](http://wiki.openstreetmap.org/wiki/Key:name) value of the water body.
+    name_en: The english `name:en` value if available.
+    class: |
+        At the moment only `lake` since no ocean parts are labelled. *Reserved for future use*.
   buffer_size: 8
   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:
-    class: String
   datasource:
     geometry_field: geometry
     srid: 900913

layers/waterway/README.md

@@ -0,0 +1,20 @@
+# waterway
+
+Rivers based of OpenStreetMap [waterways](http://wiki.openstreetmap.org/wiki/Waterways) for *z8* to *z14*
+and Natural Earth rivers and lake centerlines from *z3* to *z7*.
+Too short linestrings are filtered out for some zoom levels. Waterways do no not have a `subclass`.
+
+## Fields
+
+- **class**: The original value of the [`waterway`](http://wiki.openstreetmap.org/wiki/Key:waterway) tag.
+Can be one of [`stream`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Dstream),
+[`river`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Driver),
+[`canal`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Dcanal),
+[`drain`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Ddrain),
+[`ditch`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Dditch)`.
+
+## Mapping
+
+![](mapping.png)
+
+

layers/waterway/waterway.yaml

@@ -1,8 +1,18 @@
 layer:
   id: "waterway"
   description: |
-      OpenStreetMap waterways.
+      Rivers based of OpenStreetMap [waterways](http://wiki.openstreetmap.org/wiki/Waterways) for *z8* to *z14*
+      and Natural Earth rivers and lake centerlines from *z3* to *z7*.
+      Too short linestrings are filtered out for some zoom levels. Waterways do no not have a `subclass`.
   buffer_size: 4
+  fields:
+    class: |
+        The original value of the [`waterway`](http://wiki.openstreetmap.org/wiki/Key:waterway) tag.
+        Can be one of [`stream`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Dstream),
+        [`river`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Driver),
+        [`canal`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Dcanal),
+        [`drain`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Ddrain),
+        [`ditch`](http://wiki.openstreetmap.org/wiki/Tag:waterway%3Dditch)`.
   datasource:
     geometry_field: geometry
     query: (SELECT geometry, class FROM layer_waterway(!bbox!, z(!scale_denominator!))) AS t