From ca28a0ac24684d837992af66fc33bbbcaf291dad Mon Sep 17 00:00:00 2001
From: lukasmartinelli <me@lukasmartinelli.ch>
Date: Fri, 28 Oct 2016 20:52:42 +0200
Subject: [PATCH] Document building

---
 Makefile                      |  5 ++++-
 layers/building/README.md     | 11 +++++++++++
 layers/building/building.yaml |  5 +++--
 3 files changed, 18 insertions(+), 3 deletions(-)
 create mode 100644 layers/building/README.md

diff --git a/Makefile b/Makefile
index 804babbf..342a6d88 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-all: build/openmaptiles.tm2source/data.yml build/mapping.yaml build/tileset.sql layers/railway/README.md layers/boundary/README.md layers/water/README.md
+all: build/openmaptiles.tm2source/data.yml build/mapping.yaml build/tileset.sql layers/railway/README.md layers/boundary/README.md layers/water/README.md layers/building/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
@@ -18,5 +18,8 @@ layers/boundary/README.md:
 layers/water/README.md:
 	generate-doc layers/water/water.yaml --diagram layers/water/mapping > layers/water/README.md
 
+layers/building/README.md:
+	generate-doc layers/building/building.yaml > layers/building/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
diff --git a/layers/building/README.md b/layers/building/README.md
new file mode 100644
index 00000000..9762193e
--- /dev/null
+++ b/layers/building/README.md
@@ -0,0 +1,11 @@
+# building
+
+All [OSM Buildings](http://wiki.openstreetmap.org/wiki/Buildings). All building tags are imported ([`building=*`](http://wiki.openstreetmap.org/wiki/Key:building)). The buildings are not yet ready for 3D rendering support and any help to improve
+this is welcomed.
+
+## Fields
+
+- **render_height**: An approximated height from levels and height of building after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear). For future 3D rendering of buildings.
+
+
+
diff --git a/layers/building/building.yaml b/layers/building/building.yaml
index c6826674..2830e23c 100644
--- a/layers/building/building.yaml
+++ b/layers/building/building.yaml
@@ -1,13 +1,14 @@
 layer:
   id: "building"
   description: |
-    All [OSM Buildings](http://wiki.openstreetmap.org/wiki/Buildings).
+      All [OSM Buildings](http://wiki.openstreetmap.org/wiki/Buildings). All building tags are imported ([`building=*`](http://wiki.openstreetmap.org/wiki/Key:building)). The buildings are not yet ready for 3D rendering support and any help to improve
+      this is welcomed.
   buffer_size: 4
   datasource:
     query: (SELECT geom FROM layer_building(!bbox!, z(!scale_denominator!))) AS t
   fields:
     render_height: |
-        An approximated height from levels and height of building after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear)
+        An approximated height from levels and height of building after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear). For future 3D rendering of buildings.
 schema:
   - ./building.sql
 datasources: