Updates documentation for 3.13 (#1350)

Adding missing information in `layers.yaml` files for 3.13

layers/building/building.yaml

@@ -1,8 +1,8 @@
 layer:
   id: "building"
   description: |
-      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.
+      All [OSM Buildings](http://wiki.openstreetmap.org/wiki/Buildings). All building tags are imported ([`building=*`](http://wiki.openstreetmap.org/wiki/Key:building)).
+      Only buildings with tag location:underground are excluded.
   buffer_size: 4
   datasource:
     geometry_field: geometry
@@ -12,9 +12,9 @@ layer:
     query: (SELECT osm_id, geometry, render_height, render_min_height, colour, hide_3d FROM layer_building(!bbox!, z(!scale_denominator!))) AS t
   fields:
     render_height: |
-        An approximated height from levels and height of the building or building:part after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear). For future 3D rendering of buildings.
+        An approximated height from levels and height of the building or building:part.
     render_min_height: |
-        An approximated height from levels and height of the bottom of the building or building:part after the method of Paul Norman in [OSM Clear](https://github.com/ClearTables/osm-clear). For future 3D rendering of buildings.
+        An approximated height from minimum levels or minimum height of the bottom of the building or building:part.
     colour: |
         Colour
     hide_3d: |

layers/mountain_peak/mountain_peak.yaml

@@ -10,10 +10,11 @@ layer:
     name_de: German name `name:de` if available, otherwise `name` or `name:en`.
     class:
       description: |
-        Use the **class** to differentiate between mountain peak and volcano.
+        Use the **class** to differentiate between natural objects.
       values:
       - peak
       - volcano
+      - saddle
       - ridge
       - cliff
       - arete

layers/poi/poi.yaml

@@ -111,7 +111,8 @@ layer:
           [`tourism`](http://wiki.openstreetmap.org/wiki/Key:tourism),
           [`aerialway`](http://wiki.openstreetmap.org/wiki/Key:aerialway),
           [`building`](http://wiki.openstreetmap.org/wiki/Key:building),
-          [`highway`](http://wiki.openstreetmap.org/wiki/Key:highway)
+          [`highway`](http://wiki.openstreetmap.org/wiki/Key:highway),
+          [`office`](https://wiki.openstreetmap.org/wiki/Key:office)
           or [`waterway`](http://wiki.openstreetmap.org/wiki/Key:waterway)
           tag.  Use this to do more precise styling.
     rank: |

layers/transportation/transportation.yaml

@@ -24,7 +24,8 @@ layer:
           [`railway`](http://wiki.openstreetmap.org/wiki/Key:railway),
           [`aerialway`](http://wiki.openstreetmap.org/wiki/Key:aerialway),
           [`route`](http://wiki.openstreetmap.org/wiki/Key:route) tag (for
-          shipping ways), or
+          shipping ways),
+          [`busway`](https://wiki.openstreetmap.org/wiki/Key:busway), or
           [`man_made`](http://wiki.openstreetmap.org/wiki/Key:man_made).
       values:
         motorway:
@@ -134,12 +135,12 @@ layer:
           Mark with `1` whether way is a oneway in the direction of the way,
           with `-1` whether way is a oneway in the opposite direction of the way
           or not a oneway with `0`.
-      values: [0, 1, -1]
+      values: [1, -1]
     ramp:
       description: |
           Mark with `1` whether way is a ramp (link or steps)
           or not with `0`.
-      values: [0, 1]
+      values: [1]
     service:
       description: |
           Original value of the [`service`](http://wiki.openstreetmap.org/wiki/Key:service) tag.

layers/water_name/water_name.yaml

@@ -6,7 +6,7 @@ layer:
       - lake_centerline
   description: |
       Lake center lines for labelling lake bodies.
-      This is based of the [osm-lakelines](https://github.com/lukasmartinelli/osm-lakelines) project
+      This is based of the [osm-lakelines](https://github.com/openmaptiles/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.
@@ -14,9 +14,11 @@ layer:
     name_de: German name `name:de` if available, otherwise `name` or `name:en`.
     class:
       description: |
-          At the moment only `lake` since no ocean parts are labelled. *Reserved for future use*.
+          Distinguish between `lake`, `ocean` and `sea`.
       values:
       - lake
+      - sea
+      - ocean
     intermittent:
       description: |
         Mark with `1` if it is an [intermittent](http://wiki.openstreetmap.org/wiki/Key:intermittent) lake.