diff --git a/Home.md b/Home.md
index c759365..1b93730 100644
--- a/Home.md
+++ b/Home.md
@@ -4,11 +4,12 @@ The **OpenMapTiles** wiki contains the generated layer documentation which can a
 
 - [boundary](boundary)
 - [building](building)
-- [highway](highway)
-- [highway_name](highway_name)
+- [transportation](transportation)
+- [transportation_name](transportation_name)
 - [housenumber](housenumber)
 - [landcover](landcover)
 - [landuse](landuse)
+- [park](park)
 - [place](place)
 - [poi](poi)
 - [railway](railway)
diff --git a/place.md b/place.md
index ebf301a..0855e47 100644
--- a/place.md
+++ b/place.md
@@ -7,31 +7,89 @@ We suggest you use different font styles and sizes to create a text hierarchy.
 
 ## Fields
 
-### name_en
-
-The english `name:en` value if available.
-
 ### name
 
 The OSM [`name`](http://wiki.openstreetmap.org/wiki/Key:name) value of the POI.
 
-### rank
+### capital
 
-Countries, states and the most important cities all have a `rank` to boost their importance on the map.
-The `rank` field for counries and states ranges from `1` to `6` while the `rank` field for
-cities ranges from `1` to `10` for the most important cities and continues from `10` serially based
-on the local importance of the city (derived from population and city class).
-Use the `rank` field to build a text hierarchy.
-The rank value is a combination of the Natural Earth `scalerank`, `labelrank` and `datarank` values for countries
-and states and for cities consists out of a shifted Natural Earth `scalerank` combined with a local rank
-within a grid for cities that do not have a Natural Earth `scalerank`.
+The **capital** field marks the
+[`admin_level`](http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative#admin_level)
+of the boundary the place is a capital of.
+
+Possible values:
+
+- `2`
+- `4`
+
+### name_en
+
+The English `name:en` value or local `name` if not available.
 
 ### class
 
-Distinguish between `country`, `state` and other city classes like
-`city`, `town`, `village`, `hamlet`, `suburb`, `neighbourhood` or `isolated_dwelling`.
-Use this to separately style the different places according to their importance (usually country and state different
-than cities).
+description: |
+    Distinguish between continents, countries, states and
+    places like settlements or smaller entities.
+    Use this to separately style the different places and build
+    a text hierarchy according to their importance.
+    than cities).
+values:
+- continent
+- country
+- state
+- settlement
+- subregion
+- other
+
+### rank
+
+Countries, states and the most important cities all have a
+**rank** to boost their importance on the map.
+The **rank** field for counries and states ranges from
+`1` to `6` while the **rank** field for cities ranges from
+`1` to `10` for the most important cities
+and continues from `10` serially based on the
+local importance of the city (derived from population and city class).
+You can use the **rank** to limit density of labels or improve
+the text hierarchy.
+The rank value is a combination of the Natural Earth
+`scalerank`, `labelrank` and `datarank` values for countries
+and states and for cities consists out of a shifted
+Natural Earth `scalerank` combined with a local rank
+within a grid for cities that do not have a Natural Earth `scalerank`.
+
+Possible values:
+
+- `1`
+- `2`
+- `3`
+- `4`
+- `5`
+- `6`
+- `7`
+- `8`
+- `9`
+- `10`
+
+### subclass
+
+Use **subclass** to do more precise styling.
+Original value of the
+[`place`](http://wiki.openstreetmap.org/wiki/Key:place) tag.
+
+Possible values:
+
+- `continent`
+- `country`
+- `state`
+- `city`
+- `town`
+- `village`
+- `hamlet`
+- `suburb`
+- `neighbourhood`
+- `isolated_dwelling`
 
 
 ## Mapping