diff --git a/examples/regularshape.html b/examples/regularshape.html
index 2a40763c50..1e3430a20a 100644
--- a/examples/regularshape.html
+++ b/examples/regularshape.html
@@ -3,7 +3,9 @@ layout: example.html
 title: Regular Shapes
 shortdesc: Example of some Regular Shape styles.
 docs: >
-
+  This example shows how several regular shapes
+  or symbols (representing `x`, `cross`, `star`,
+  `triangle` and `square`) can be created.
 tags: "vector, symbol, regularshape, style, square, cross, star, triangle, x"
 ---
 <div id="map" class="map"></div>