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