docs: Update documentation

docs/api/draw-functions/shapes/polygon.mdx

@@ -0,0 +1,5 @@
+import Polygon from "@site/cetz/docs/_generated/draw/shapes/polygon.mdx";
+
+# polygon
+
+<Polygon />

docs/api/draw-functions/shapes/shapes.md

@@ -6,6 +6,7 @@ Draw functions that draw shapes onto the canvas, be that lines, circles or curve
 - [arc](./arc) Draws an arc between two points.
 - [mark](./mark) Draws a mark at a point in a direction.
 - [line](./line) Draws a line between two points, or a line strip between 3 or more points.
+- [polygon](./polygon) Draws a regular polygon.
 - [grid](./grid) Draws a grid.
 - [content](./content) Places some content on the canvas.
 - [rect](./rect) Draws a rectangle between two points.

docs/api/sidebar.js

@@ -21,6 +21,7 @@ export default [
           "api/draw-functions/shapes/arc",
           "api/draw-functions/shapes/mark",
           "api/draw-functions/shapes/line",
+          "api/draw-functions/shapes/polygon",
           "api/draw-functions/shapes/grid",
           "api/draw-functions/shapes/content",
           "api/draw-functions/shapes/rect",
@@ -42,6 +43,7 @@ export default [
           "api/draw-functions/grouping/intersections",
           "api/draw-functions/grouping/group",
           "api/draw-functions/grouping/anchor",
+          "api/draw-functions/grouping/scope",
           "api/draw-functions/grouping/copy-anchors",
           "api/draw-functions/grouping/set-ctx",
           "api/draw-functions/grouping/get-ctx",

src/draw/shapes.typ

@@ -591,6 +591,12 @@
 
 /// Draws a regular polygon.
 ///
+/// ```typc example
+/// polygon((0,0), 3, angle: 90deg)
+/// polygon((2,0), 5)
+/// polygon((4,0), 7)
+/// ```
+///
 /// - origin (coordinate): Coordinate to draw the polygon at
 /// - sides (int): Number of sides of the polygon (>= 3)
 /// - angle (angle) = 0deg: Angle angle to rotate the polygon arround its origin