Extend docs for park, landuse, landcover

layers/landcover/landcover.yaml

@@ -2,16 +2,17 @@ layer:
   id: "landcover"
   description: |
       Landcover is used to describe the physical material at the surface of the earth. At lower zoom levels this is
-      from Natural Earth data for glaciers and ice shelves and at higher zoom levels the landcover is implied
-      by OSM tags (like `landuse` or `natural`).
+      from Natural Earth data for glaciers and ice shelves and at higher zoom levels the [landcover is [implied by OSM tags](http://wiki.openstreetmap.org/wiki/Landcover). The most common use case for this layer
+        is to style wood (`class=wood`) and grass (`class=`grass`) areas.
   buffer_size: 4
   fields:
     class: |
-        More generalized groups of either `farmland`, `ice`, `wood`, `grass` or `wetland`.
+        More generalized groups of either `farmland`, `ice`, `wood`, `grass`
+        or `wetland`.
         Use this to assign general colors to the landcover.
     subclass: |
-        Original value of either the `landuse`, `natural` or `wetland` tag.
-        Use this to do more precise styling.
+        Original value of either the `landuse`, `natural`, `leisure` or
+        `wetland` tag. Use this to do more precise styling.
   datasource:
     geometry_field: geometry
     query: (SELECT geometry, class, subclass FROM layer_landcover(!bbox!, z(!scale_denominator!))) AS t

layers/landuse/landuse.yaml

@@ -6,14 +6,19 @@ layer:
   buffer_size: 4
   fields:
     class: |
-        More generalized groups of either `park`, `school`, `hospital`, `railway`,
-        `cemetery`, `military`, `residential`. Use this to assign general for landuse.
-    subclass: |
-        Original value of either the `amenity`, `landuse`, `leisure` or `boundary` tag.
-        Use this to do more precise styling.
+        Original value of either the `amenity`, `landuse`, `leisure`
+        tag.  Use this to assign special colors to areas.
+        Either `school`, `university`, `kindergarten`, `college`,
+        `library`, `hospital` (from the
+        [`amenity`](http://wiki.openstreetmap.org/wiki/Key:amenity) key)
+        or `railway`, `cemetery`, `military`, `residential`,
+        `commercial`, `industrial`, `retail` (from the
+        [`landuse`](http://wiki.openstreetmap.org/wiki/Key:landuse) key)
+        as well as `stadium` (from the
+        [`leisure`](http://wiki.openstreetmap.org/wiki/Key:leisure) key).
   datasource:
     geometry_field: geometry
-    query: (SELECT geometry, class, subclass FROM layer_landuse(!bbox!, z(!scale_denominator!))) AS t
+    query: (SELECT geometry, class FROM layer_landuse(!bbox!, z(!scale_denominator!))) AS t
 schema:
   - ./landuse.sql
 datasources:

layers/park/park.yaml

@@ -1,16 +1,11 @@
 layer:
   id: "park"
   description: |
-      Landuse is used to describe use of land by humans.At lower zoom levels this is
-      from Natural Earth data for residential (urban) areas and at higher zoom levels mostly OSM `landuse` tags.
+      The park layer contains parks from OpenStreetMap tagged with either [`boundary=national_park`](http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dnational_park) or [`leisure=nature_reserve`](http://wiki.openstreetmap.org/wiki/Tag:leisure%3Dnature_reserve).
   buffer_size: 4
   fields:
     class: |
-        More generalized groups of either `park`, `school`, `hospital`, `railway`,
-        `cemetery`, `military`, `residential`. Use this to assign general for landuse.
-    subclass: |
-        Original value of either the `amenity`, `landuse`, `leisure` or `boundary` tag.
-        Use this to do more precise styling.
+        Either `national_park` or `nature_reserve`.
   datasource:
     geometry_field: geometry
     query: (SELECT geometry, class FROM layer_park(!bbox!, z(!scale_denominator!))) AS t