diff --git a/docs/dsl/polygon.rst b/docs/dsl/polygon.rst
index 57e7d3d..59eee98 100644
--- a/docs/dsl/polygon.rst
+++ b/docs/dsl/polygon.rst
@@ -7,6 +7,11 @@ Options
 ^^^^^^^
 .. include:: /args/expansion.rst
 
+n
+  default: 5
+
+  the number of sides on the polygon
+
 .. include:: /args/xy.rst
 
 radius
diff --git a/docs/dsl/star.rst b/docs/dsl/star.rst
index 09815e8..8874f23 100644
--- a/docs/dsl/star.rst
+++ b/docs/dsl/star.rst
@@ -7,6 +7,11 @@ Options
 ^^^^^^^
 .. include:: /args/expansion.rst
 
+n
+  default: 5
+
+  the number of points on the star
+
 .. include:: /args/xy.rst
 
 inner_radius