Add docs for landcover, landuse and housenumber

Makefile

@@ -1,7 +1,7 @@
 all: build/openmaptiles.tm2source/data.yml build/mapping.yaml build/tileset.sql
 
 .PHONY: docs
-docs: layers/railway/README.md layers/boundary/README.md layers/water/README.md layers/building/README.md layers/highway/README.md layers/highway_name/README.md layers/poi/README.md layers/place/README.md layers/waterway/README.md layers/water_name/README.md
+docs: layers/railway/README.md layers/boundary/README.md layers/water/README.md layers/building/README.md layers/highway/README.md layers/highway_name/README.md layers/poi/README.md layers/place/README.md layers/waterway/README.md layers/water_name/README.md layers/landcover/README.md layers/landuse/README.md layers/housenumber/README.md
 
 build/openmaptiles.tm2source/data.yml:
 	mkdir -p build/openmaptiles.tm2source && generate-tm2source openmaptiles.yaml --host="postgres" --port=5432 --database="openmaptiles" --user="openmaptiles" --password="openmaptiles" > build/openmaptiles.tm2source/data.yml
@@ -42,5 +42,14 @@ layers/building/README.md:
 layers/place/README.md:
 	generate-doc layers/place/place.yaml --diagram layers/place/mapping > layers/place/README.md
 
+layers/landuse/README.md:
+	generate-doc layers/landuse/landuse.yaml --diagram layers/landuse/mapping > layers/landuse/README.md
+
+layers/landcover/README.md:
+	generate-doc layers/landcover/landcover.yaml --diagram layers/landcover/mapping > layers/landcover/README.md
+
+layers/housenumber/README.md:
+	generate-doc layers/housenumber/housenumber.yaml > layers/housenumber/README.md
+
 clean:
 	rm -f build/openmaptiles.tm2source/data.yml && rm -f build/mapping.yaml && rm -f build/tileset.sql && rm -f layers/**/README.md&& rm -f layers/**/*.png

layers/housenumber/README.md

@@ -0,0 +1,11 @@
+# housenumber
+
+Everything in OpenStreetMap which contains a `addr:housenumber` tag useful for labelling housenumbers on a map.
+This adds significant size to zoom level 14. For buildings the centroid of the building is used as housenumber.
+
+## Fields
+
+- **housenumber**: Value of the [`addr:housenumber`](http://wiki.openstreetmap.org/wiki/Key:addr) tag.
+
+
+

layers/housenumber/housenumber.yaml

@@ -1,11 +1,12 @@
 layer:
   id: "housenumber"
   description: |
-      [OpenStreetMap housenumbers]
+      Everything in OpenStreetMap which contains a `addr:housenumber` tag useful for labelling housenumbers on a map.
+      This adds significant size to *z14*. For buildings the centroid of the building is used as housenumber.
   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
+    housenumber: Value of the [`addr:housenumber`](http://wiki.openstreetmap.org/wiki/Key:addr) tag.
   datasource:
     geometry_field: geometry
     srid: 900913

layers/landcover/README.md

@@ -0,0 +1,18 @@
+# landcover
+
+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`).
+
+## Fields
+
+- **class**: 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.
+
+## Mapping
+
+![](mapping.png)
+
+

layers/landcover/landcover.yaml

@@ -1,7 +1,17 @@
 layer:
   id: "landcover"
-  description: Landcover is used to describe the physical material at the surface of the earth. Land covers include grass, asphalt, trees, bare ground etc. Tagging of landcover is often only implied by other tags at present, for example a park may be assumed to be covered in grass, but in some places this may in fact be trees or sand or some other cover. The following keys imply or specifically indicate landcover properties.
+  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`).
   buffer_size: 4
+  fields:
+    class: |
+        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.
   datasource:
     geometry_field: geometry
     query: (SELECT geometry, class, subclass FROM layer_landcover(!bbox!, z(!scale_denominator!))) AS t

layers/landuse/README.md

@@ -0,0 +1,17 @@
+# landuse
+
+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.
+
+## 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.
+
+## Mapping
+
+![](mapping.png)
+
+

layers/landuse/landuse.yaml

@@ -1,7 +1,16 @@
 layer:
   id: "landuse"
-  description: Landcover is used to describe the physical material at the surface of the earth. Land covers include grass, asphalt, trees, bare ground etc. Tagging of landcover is often only implied by other tags at present, for example a park may be assumed to be covered in grass, but in some places this may in fact be trees or sand or some other cover. The following keys imply or specifically indicate landcover properties.
+  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.
   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.
   datasource:
     geometry_field: geometry
     query: (SELECT geometry, class, subclass FROM layer_landuse(!bbox!, z(!scale_denominator!))) AS t