diff --git a/layers/boundary/boundary.yaml b/layers/boundary/boundary.yaml
index 90555d7..7ed4704 100644
--- a/layers/boundary/boundary.yaml
+++ b/layers/boundary/boundary.yaml
@@ -1,10 +1,11 @@
 layer:
   id: "boundary"
   description: |
-      Contains administrative boundaries (no maritime boundaries yet) as linestrings.
-      Until z7 [Natural Earth data](http://www.naturalearthdata.com/downloads/10m-cultural-vectors/10m-admin-0-countries/)
-      is used after which OSM boundaries ([`boundary=administrative`](http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative)) are present from z8 to z14.
-      OSM data contains all [`admin_level`](http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative#admin_level)
+      Contains administrative boundaries as linestrings.
+      Until z5 [Natural Earth data](http://www.naturalearthdata.com/downloads/) is used after which 
+      OSM boundaries ([`boundary=administrative`](http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative)) 
+      are present from z6 to z14 (also for maritime boundaries with admin_level <= 2 at z4 and z5).
+      OSM data contains several [`admin_level`](http://wiki.openstreetmap.org/wiki/Tag:boundary%3Dadministrative#admin_level)
       but for most styles it makes sense to just style `admin_level=2` and `admin_level=4`.
   fields:
     admin_level: |