Misc docs polishing (#6712)

* Fake modules for Rust std lib functions

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Include the missing @ in Rust std lib fns

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Move revolve and mirror2d to better modules

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Use docs from KCL mods for type summaries

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Use type docs to describe types from KCL std lib

Signed-off-by: Nick Cameron <nrc@ncameron.org>

---------

Signed-off-by: Nick Cameron <nrc@ncameron.org>

docs/kcl-std/functions/std-helix.md

@@ -34,7 +34,7 @@ helix(
 
 ### Returns
 
-[`Helix`](/docs/kcl-std/types/std-types-Helix)
+[`Helix`](/docs/kcl-std/types/std-types-Helix) - A helix.
 
 
 ### Examples

docs/kcl-std/functions/std-math-abs.md

@@ -16,11 +16,11 @@ abs(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-ceil.md

@@ -16,11 +16,11 @@ ceil(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-floor.md

@@ -16,11 +16,11 @@ floor(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-ln.md

@@ -16,11 +16,11 @@ ln(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-log.md

@@ -26,7 +26,7 @@ log(
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-log10.md

@@ -16,11 +16,11 @@ log10(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-log2.md

@@ -16,11 +16,11 @@ log2(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-max.md

@@ -20,7 +20,7 @@ max(@input: [number; 1+]): number
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-min.md

@@ -20,7 +20,7 @@ min(@input: [number; 1+]): number
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-polar.md

@@ -25,7 +25,7 @@ polar(
 
 ### Returns
 
-[`Point2d`](/docs/kcl-std/types/std-types-Point2d)
+[`Point2d`](/docs/kcl-std/types/std-types-Point2d) - A point in two dimensional space.
 
 
 ### Examples

docs/kcl-std/functions/std-math-pow.md

@@ -24,7 +24,7 @@ pow(
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-rem.md

@@ -25,7 +25,7 @@ rem(
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-round.md

@@ -16,11 +16,11 @@ round(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-math-sqrt.md

@@ -16,11 +16,11 @@ sqrt(@input: number): number
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `input` | [`number`](/docs/kcl-std/types/std-types-number) |  | Yes |
+| `input` | [`number`](/docs/kcl-std/types/std-types-number) | A number | Yes |
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/functions/std-offsetPlane.md

@@ -25,7 +25,7 @@ offsetPlane(
 
 ### Returns
 
-[`Plane`](/docs/kcl-std/types/std-types-Plane)
+[`Plane`](/docs/kcl-std/types/std-types-Plane) - A plane.
 
 
 ### Examples

docs/kcl-std/functions/std-sketch-circle.md

@@ -29,7 +29,7 @@ circle(
 
 ### Returns
 
-[`Sketch`](/docs/kcl-std/types/std-types-Sketch)
+[`Sketch`](/docs/kcl-std/types/std-types-Sketch) - A sketch is a collection of paths.
 
 
 ### Examples

docs/kcl-std/functions/std-solid-chamfer.md

@@ -30,7 +30,7 @@ chamfer(
 
 ### Returns
 
-[`Solid`](/docs/kcl-std/types/std-types-Solid)
+[`Solid`](/docs/kcl-std/types/std-types-Solid) - A solid is a collection of extrude surfaces.
 
 
 ### Examples

docs/kcl-std/functions/std-solid-fillet.md

@@ -32,7 +32,7 @@ fillet(
 
 ### Returns
 
-[`Solid`](/docs/kcl-std/types/std-types-Solid)
+[`Solid`](/docs/kcl-std/types/std-types-Solid) - A solid is a collection of extrude surfaces.
 
 
 ### Examples

docs/kcl-std/functions/std-solid-hollow.md

@@ -25,7 +25,7 @@ hollow(
 
 ### Returns
 
-[`Solid`](/docs/kcl-std/types/std-types-Solid)
+[`Solid`](/docs/kcl-std/types/std-types-Solid) - A solid is a collection of extrude surfaces.
 
 
 ### Examples

docs/kcl-std/index.md

@@ -9,68 +9,18 @@ layout: manual
 ### Functions
 
 * [**std**](/docs/kcl-std/modules/std)
-  * [`angledLine`](/docs/kcl-std/angledLine)
-  * [`angledLineThatIntersects`](/docs/kcl-std/angledLineThatIntersects)
   * [`appearance`](/docs/kcl-std/appearance)
-  * [`arc`](/docs/kcl-std/arc)
   * [`assert`](/docs/kcl-std/assert)
   * [`assertIs`](/docs/kcl-std/assertIs)
-  * [`bezierCurve`](/docs/kcl-std/bezierCurve)
-  * [`circleThreePoint`](/docs/kcl-std/circleThreePoint)
   * [`clone`](/docs/kcl-std/clone)
-  * [`close`](/docs/kcl-std/close)
-  * [`extrude`](/docs/kcl-std/extrude)
-  * [`getCommonEdge`](/docs/kcl-std/getCommonEdge)
-  * [`getNextAdjacentEdge`](/docs/kcl-std/getNextAdjacentEdge)
-  * [`getOppositeEdge`](/docs/kcl-std/getOppositeEdge)
-  * [`getPreviousAdjacentEdge`](/docs/kcl-std/getPreviousAdjacentEdge)
   * [`helix`](/docs/kcl-std/functions/std-helix)
-  * [`intersect`](/docs/kcl-std/intersect)
-  * [`involuteCircular`](/docs/kcl-std/involuteCircular)
-  * [`lastSegX`](/docs/kcl-std/lastSegX)
-  * [`lastSegY`](/docs/kcl-std/lastSegY)
-  * [`legAngX`](/docs/kcl-std/legAngX)
-  * [`legAngY`](/docs/kcl-std/legAngY)
-  * [`legLen`](/docs/kcl-std/legLen)
-  * [`line`](/docs/kcl-std/line)
-  * [`loft`](/docs/kcl-std/loft)
-  * [`map`](/docs/kcl-std/map)
   * [`offsetPlane`](/docs/kcl-std/functions/std-offsetPlane)
-  * [`patternCircular2d`](/docs/kcl-std/patternCircular2d)
-  * [`patternCircular3d`](/docs/kcl-std/patternCircular3d)
   * [`patternLinear2d`](/docs/kcl-std/patternLinear2d)
-  * [`patternLinear3d`](/docs/kcl-std/patternLinear3d)
-  * [`patternTransform`](/docs/kcl-std/patternTransform)
-  * [`patternTransform2d`](/docs/kcl-std/patternTransform2d)
-  * [`polygon`](/docs/kcl-std/polygon)
+* [**std::array**](/docs/kcl-std/modules/std-array)
+  * [`map`](/docs/kcl-std/map)
   * [`pop`](/docs/kcl-std/pop)
-  * [`profileStart`](/docs/kcl-std/profileStart)
-  * [`profileStartX`](/docs/kcl-std/profileStartX)
-  * [`profileStartY`](/docs/kcl-std/profileStartY)
   * [`push`](/docs/kcl-std/push)
   * [`reduce`](/docs/kcl-std/reduce)
-  * [`revolve`](/docs/kcl-std/functions/std-revolve)
-  * [`rotate`](/docs/kcl-std/rotate)
-  * [`scale`](/docs/kcl-std/scale)
-  * [`segAng`](/docs/kcl-std/segAng)
-  * [`segEnd`](/docs/kcl-std/segEnd)
-  * [`segEndX`](/docs/kcl-std/segEndX)
-  * [`segEndY`](/docs/kcl-std/segEndY)
-  * [`segLen`](/docs/kcl-std/segLen)
-  * [`segStart`](/docs/kcl-std/segStart)
-  * [`segStartX`](/docs/kcl-std/segStartX)
-  * [`segStartY`](/docs/kcl-std/segStartY)
-  * [`startProfile`](/docs/kcl-std/startProfile)
-  * [`startSketchOn`](/docs/kcl-std/startSketchOn)
-  * [`subtract`](/docs/kcl-std/subtract)
-  * [`subtract2d`](/docs/kcl-std/subtract2d)
-  * [`sweep`](/docs/kcl-std/sweep)
-  * [`tangentToEnd`](/docs/kcl-std/tangentToEnd)
-  * [`tangentialArc`](/docs/kcl-std/tangentialArc)
-  * [`translate`](/docs/kcl-std/translate)
-  * [`union`](/docs/kcl-std/union)
-  * [`xLine`](/docs/kcl-std/xLine)
-  * [`yLine`](/docs/kcl-std/yLine)
 * [**std::math**](/docs/kcl-std/modules/std-math)
   * [`abs`](/docs/kcl-std/functions/std-math-abs)
   * [`acos`](/docs/kcl-std/functions/std-math-acos)
@@ -80,6 +30,9 @@ layout: manual
   * [`ceil`](/docs/kcl-std/functions/std-math-ceil)
   * [`cos`](/docs/kcl-std/functions/std-math-cos)
   * [`floor`](/docs/kcl-std/functions/std-math-floor)
+  * [`legAngX`](/docs/kcl-std/legAngX)
+  * [`legAngY`](/docs/kcl-std/legAngY)
+  * [`legLen`](/docs/kcl-std/legLen)
   * [`ln`](/docs/kcl-std/functions/std-math-ln)
   * [`log`](/docs/kcl-std/functions/std-math-log)
   * [`log10`](/docs/kcl-std/functions/std-math-log10)
@@ -94,13 +47,62 @@ layout: manual
   * [`sqrt`](/docs/kcl-std/functions/std-math-sqrt)
   * [`tan`](/docs/kcl-std/functions/std-math-tan)
 * [**std::sketch**](/docs/kcl-std/modules/std-sketch)
+  * [`angledLine`](/docs/kcl-std/angledLine)
+  * [`angledLineThatIntersects`](/docs/kcl-std/angledLineThatIntersects)
+  * [`arc`](/docs/kcl-std/arc)
+  * [`bezierCurve`](/docs/kcl-std/bezierCurve)
   * [`circle`](/docs/kcl-std/functions/std-sketch-circle)
-  * [`mirror2d`](/docs/kcl-std/functions/std-sketch-mirror2d)
+  * [`circleThreePoint`](/docs/kcl-std/circleThreePoint)
+  * [`close`](/docs/kcl-std/close)
+  * [`extrude`](/docs/kcl-std/extrude)
+  * [`getCommonEdge`](/docs/kcl-std/getCommonEdge)
+  * [`getNextAdjacentEdge`](/docs/kcl-std/getNextAdjacentEdge)
+  * [`getOppositeEdge`](/docs/kcl-std/getOppositeEdge)
+  * [`getPreviousAdjacentEdge`](/docs/kcl-std/getPreviousAdjacentEdge)
+  * [`involuteCircular`](/docs/kcl-std/involuteCircular)
+  * [`lastSegX`](/docs/kcl-std/lastSegX)
+  * [`lastSegY`](/docs/kcl-std/lastSegY)
+  * [`line`](/docs/kcl-std/line)
+  * [`loft`](/docs/kcl-std/loft)
+  * [`patternCircular2d`](/docs/kcl-std/patternCircular2d)
+  * [`patternTransform2d`](/docs/kcl-std/patternTransform2d)
+  * [`polygon`](/docs/kcl-std/polygon)
+  * [`profileStart`](/docs/kcl-std/profileStart)
+  * [`profileStartX`](/docs/kcl-std/profileStartX)
+  * [`profileStartY`](/docs/kcl-std/profileStartY)
+  * [`revolve`](/docs/kcl-std/functions/std-sketch-revolve)
+  * [`segAng`](/docs/kcl-std/segAng)
+  * [`segEnd`](/docs/kcl-std/segEnd)
+  * [`segEndX`](/docs/kcl-std/segEndX)
+  * [`segEndY`](/docs/kcl-std/segEndY)
+  * [`segLen`](/docs/kcl-std/segLen)
+  * [`segStart`](/docs/kcl-std/segStart)
+  * [`segStartX`](/docs/kcl-std/segStartX)
+  * [`segStartY`](/docs/kcl-std/segStartY)
+  * [`startProfile`](/docs/kcl-std/startProfile)
+  * [`startSketchOn`](/docs/kcl-std/startSketchOn)
+  * [`subtract2d`](/docs/kcl-std/subtract2d)
+  * [`sweep`](/docs/kcl-std/sweep)
+  * [`tangentToEnd`](/docs/kcl-std/tangentToEnd)
+  * [`tangentialArc`](/docs/kcl-std/tangentialArc)
+  * [`xLine`](/docs/kcl-std/xLine)
+  * [`yLine`](/docs/kcl-std/yLine)
 * [**std::solid**](/docs/kcl-std/modules/std-solid)
   * [`chamfer`](/docs/kcl-std/functions/std-solid-chamfer)
   * [`fillet`](/docs/kcl-std/functions/std-solid-fillet)
   * [`hollow`](/docs/kcl-std/functions/std-solid-hollow)
+  * [`intersect`](/docs/kcl-std/intersect)
+  * [`patternCircular3d`](/docs/kcl-std/patternCircular3d)
+  * [`patternLinear3d`](/docs/kcl-std/patternLinear3d)
+  * [`patternTransform`](/docs/kcl-std/patternTransform)
   * [`shell`](/docs/kcl-std/functions/std-solid-shell)
+  * [`subtract`](/docs/kcl-std/subtract)
+  * [`union`](/docs/kcl-std/union)
+* [**std::transform**](/docs/kcl-std/modules/std-transform)
+  * [`mirror2d`](/docs/kcl-std/functions/std-transform-mirror2d)
+  * [`rotate`](/docs/kcl-std/rotate)
+  * [`scale`](/docs/kcl-std/scale)
+  * [`translate`](/docs/kcl-std/translate)
 * [**std::units**](/docs/kcl-std/modules/std-units)
   * [`units::toCentimeters`](/docs/kcl-std/functions/std-units-toCentimeters)
   * [`units::toDegrees`](/docs/kcl-std/functions/std-units-toDegrees)

docs/kcl-std/legAngX.md

@@ -1,5 +1,5 @@
 ---
-title: "legAngX"
+title: "std::math::legAngX"
 excerpt: "Compute the angle of the given leg for x."
 layout: manual
 ---
@@ -24,7 +24,7 @@ legAngX(
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/legAngY.md

@@ -1,5 +1,5 @@
 ---
-title: "legAngY"
+title: "std::math::legAngY"
 excerpt: "Compute the angle of the given leg for y."
 layout: manual
 ---
@@ -24,7 +24,7 @@ legAngY(
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/legLen.md

@@ -1,5 +1,5 @@
 ---
-title: "legLen"
+title: "std::math::legLen"
 excerpt: "Compute the length of the given leg."
 layout: manual
 ---
@@ -24,7 +24,7 @@ legLen(
 
 ### Returns
 
-[`number`](/docs/kcl-std/types/std-types-number)
+[`number`](/docs/kcl-std/types/std-types-number) - A number
 
 
 ### Examples

docs/kcl-std/modules/std-array.md

@@ -0,0 +1,12 @@
+---
+title: "std::array"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+
+

docs/kcl-std/modules/std-sketch.md

@@ -12,5 +12,5 @@ layout: manual
 ## Functions and constants
 
 * [`circle`](/docs/kcl-std/functions/std-sketch-circle)
-* [`mirror2d`](/docs/kcl-std/functions/std-sketch-mirror2d)
+* [`revolve`](/docs/kcl-std/functions/std-sketch-revolve)
 

docs/kcl-std/modules/std-transform.md

@@ -0,0 +1,15 @@
+---
+title: "std::transform"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+
+## Functions and constants
+
+* [`mirror2d`](/docs/kcl-std/functions/std-transform-mirror2d)
+

docs/kcl-std/modules/std.md

@@ -10,9 +10,11 @@ Contains frequently used constants, functions for interacting with the KittyCAD
 
 ## Modules
 
+* [`array`](/docs/kcl-std/modules/std-array)
 * [`math`](/docs/kcl-std/modules/std-math)
 * [`sketch`](/docs/kcl-std/modules/std-sketch)
 * [`solid`](/docs/kcl-std/modules/std-solid)
+* [`transform`](/docs/kcl-std/modules/std-transform)
 * [`turns::turns`](/docs/kcl-std/modules/std-turns)
 * [`types`](/docs/kcl-std/modules/std-types)
 * [`units::units`](/docs/kcl-std/modules/std-units)
@@ -29,5 +31,4 @@ Contains frequently used constants, functions for interacting with the KittyCAD
 * [`Z`](/docs/kcl-std/consts/std-Z)
 * [`helix`](/docs/kcl-std/functions/std-helix)
 * [`offsetPlane`](/docs/kcl-std/functions/std-offsetPlane)
-* [`revolve`](/docs/kcl-std/functions/std-revolve)