Update documentation

Author: adamgraham

Documentation~/articles/custom-meshes.md

@@ -11,7 +11,7 @@ The **Graphics Utils** package includes a few custom cube meshes.
 - `Cube-Inverted.mesh`: cube mesh with inverted normals and triangles (inside-out)
 - `Cube-Tiling.mesh` cube mesh designed specifically for [Material Tiling](/manual/material-tiling)
 
-There are also 3 different scripts to generate cube meshes at runtime:
+There are also 3 different scripts to generate these cube meshes at runtime:
 
 - [CubeMesh](/api/Zigurous.Graphics/CubeMesh)
 - [CubeMesh3](/api/Zigurous.Graphics/CubeMesh3)
@@ -38,7 +38,7 @@ int[] triangles = mesh.InvertedTriangles();
 
 ## 🔰 Combining Meshes
 
-The **Graphics Utils** package includes a script to combine multiple meshes into a single mesh. This can sometimes be used to improve rendering performance, or as a way to create custom meshes and turn them into assets. Add the [CombineChildrenMeshes](/api/Zigurous.Graphics/CombineChildrenMeshes) script to a game object that includes an empty mesh filter. The script will combine the meshes of the children objects and apply the new combined mesh to the parent mesh filter.
+The **Graphics Utils** package includes a script to combine multiple meshes into a single mesh. This can be used to improve rendering performance, or as a way to create custom meshes and turn them into assets. Add the [CombineChildrenMeshes](/api/Zigurous.Graphics/CombineChildrenMeshes) script to the parent game object of children meshes. The combined mesh will be assigned to the mesh filter of the parent object, and the child game objects will either be destroyed or disabled.
 
 You can also manually combine meshes through an extension method:
 
@@ -51,7 +51,7 @@ Mesh combinedMesh = filters.CombineMesh();
 
 ## 💾 Saving Meshes
 
-Often when generating meshes at runtime, you may want to save that mesh as an asset for future use so you do not need to regenerate them over and over. The **Graphics Utils** package comes with a [SaveMesh](/api/Zigurous.Graphics/SaveMesh) script that will save a mesh as an asset at runtime.
+Often when generating meshes at runtime, you may want to save that mesh as an asset for future use so you don't need to regenerate them again. The **Graphics Utils** package comes with a [SaveMesh](/api/Zigurous.Graphics/SaveMesh) script that will save a mesh as an asset at runtime.
 
 You can also manually save a mesh through extension methods:
 

Documentation~/articles/extension-methods.md

@@ -0,0 +1,15 @@
+---
+slug: "/manual/extension-methods"
+---
+
+# Extension Methods
+
+The **Graphics Utils** package contains dozens of extension methods to provide enhanced support for common Unity classes. See each Scripting API for more information:
+
+#### [Material](/api/Zigurous.Architecture/MaterialExtensions)
+
+#### [Mesh](/api/Zigurous.Architecture/MeshExtensions)
+
+#### [MeshFilter](/api/Zigurous.Architecture/MeshFilterExtensions)
+
+#### [Texture](/api/Zigurous.Architecture/TextureExtensions)

Documentation~/articles/index.md

@@ -22,10 +22,12 @@ The **Graphics Utils** package provides scripts and utilities for graphics and r
 
 ## Reference
 
-#### 🛤️ [Material Tiling](/manual/material-tiling)
-
 #### 🔰 [Custom Meshes](/manual/custom-meshes)
 
-#### 🌌 [Shader Properties](/manual/shader-properties)
+#### ⛰️ [Procedural Generation](/manual/procedural-generation)
+
+#### 🛤️ [Material Tiling](/manual/material-tiling)
 
 #### 🖼️ [Texture Drawers](/manual/texture-drawers)
+
+#### 🔌 [Extension Methods](/manual/extension-methods)

Documentation~/articles/procedural-generation.md

@@ -0,0 +1,38 @@
+---
+slug: "/manual/procedural-generation"
+---
+
+# Procedural Generation
+
+The **Graphics Utils** package provides a utility class to generate procedural meshes at runtime. For example, use the [MeshGenerator](/api/Zigurous.Graphics/MeshGenerator) class to create a new procedural mesh that forms a grid of points.
+
+```csharp
+Mesh mesh = MeshGenerator.Create(64, 64);
+```
+
+This is a useful starting point to create more complex meshes, such as procedural terrain. The [MeshGenerator](/api/Zigurous.Graphics/MeshGenerator) class allows you to provide your own custom vertex generation function to create these more complex meshes.
+
+```csharp
+void GenerateTerrain()
+{
+    Mesh terrain = MeshGenerator.Create(64, 64, VertexGenerator);
+}
+
+void VertexGenerator(int x, int y, float u, float v)
+{
+    // sample terrain height using a noise function
+    float height = Mathf.PerlinNoise(x, y);
+    return new Vector3(x, height, y);
+}
+```
+
+<hr/>
+
+## 💎 Triangulation
+
+Sometimes it is useful to split a polygon into triangles in order to generate a custom mesh for the polygon. The [Triangulator](/api/Zigurous.Graphics/Triangulator) class provides this utility. Pass in the points that form the polygon, and the indices of the triangles will be returned.
+
+```csharp
+Vector2[] polygon; // array of points that form a polygon
+int[] triangles = Triangulator.Triangulate(polygon);
+```

Documentation~/articles/shader-properties.md

@@ -4,9 +4,14 @@ slug: "/manual/texture-drawers"
 
 # Texture Drawers
 
-The **Graphics Utils** package includes a base class for drawing textures at runtime. It provides the boilerplate code for creating and drawing new textures programmatically. Create a new class that inherits from [TextureDrawer](/api/Zigurous.Graphics/TextureDrawer) and override the function `SetPixels(Texture2D)` to complete the implementation.
+The **Graphics Utils** package includes a base class for drawing textures at runtime. It provides the boilerplate code for creating and drawing new textures programmatically.
+
+Create a new class that inherits from [TextureDrawer](/api/Zigurous.Graphics/TextureDrawer) and override the function `SetPixels(Texture2D)` to complete the implementation.
+
+Since [TextureDrawer](/api/Zigurous.Graphics/TextureDrawer) is a ScriptableObject, you'll want to add the `[CreateAssetMenu]` attribute to your class so you can save an instance of the class as an asset in your project using Unity's asset menu.
 
 ```csharp
+[CreateAssetMenu]
 public class CustomTextureDrawer : TextureDrawer
 {
     public override void SetPixels(Texture2D texture)
@@ -20,10 +25,14 @@ public class CustomTextureDrawer : TextureDrawer
 
 ## 🖼️ Rendering
 
-The [TextureDrawer](/api/Zigurous.Graphics/TextureDrawer) script will automatically apply your texture to the renderer's main material on the object if a Renderer component is available. This is not required, but often is useful. There are additional customization options available in regards to the rendering, such as which shader property the texture is set to.
+The **Graphics Utils** package comes with a script to quickly render the result of a [TextureDrawer](/api/Zigurous.Graphics/TextureDrawer). This is an optional, but useful script to preview the texture without having to write any other code to manually assign the texture to a material.
+
+Add the [TextureDrawerRenderer](/api/Zigurous.Graphics/TextureDrawerRenderer) script to any game object that contains any type of Renderer component. Assign the texture drawer you want to use and customize any other options you'd like. You can even render the texture in the editor without having to run the game.
 
 <hr/>
 
 ## 🏁 Checkerboard
 
 The **Graphics Utils** package includes a script [CheckerboardTextureDrawer](/api/Zigurous.Graphics/CheckerboardTextureDrawer) as a sample implementation. It is, of course, a fully functional script that draws a checkerboard pattern. This can be used however you desire, and there are even a number of customization options available.
+
+To create a new checkerboard pattern texture, use the asset menu `Create > Zigurous > Graphics > Checkerboard Texture Drawer`.

Documentation~/articles/texture-drawers.md

@@ -23,21 +23,25 @@
   {
     "title": "📖 Reference",
     "items": [
-      {
-        "name": "Material Tiling",
-        "path": "/manual/material-tiling"
-      },
       {
         "name": "Custom Meshes",
         "path": "/manual/custom-meshes"
       },
       {
-        "name": "Shader Properties",
-        "path": "/manual/shader-properties"
+        "name": "Procedural Generation",
+        "path": "/manual/procedural-generation"
+      },
+      {
+        "name": "Material Tiling",
+        "path": "/manual/material-tiling"
       },
       {
         "name": "Texture Drawers",
         "path": "/manual/texture-drawers"
+      },
+      {
+        "name": "Extension Methods",
+        "path": "/manual/extension-methods"
       }
     ]
   },

Documentation~/data/sidenav.json

@@ -6,10 +6,11 @@ The **Graphics Utils** package provides scripts and utilities for graphics and r
 
 ## Reference
 
-- [Auto Tiling](https://docs.zigurous.com/com.zigurous.graphics/manual/material-tiling)
 - [Custom Meshes](https://docs.zigurous.com/com.zigurous.graphics/manual/custom-meshes)
-- [Shader Properties](https://docs.zigurous.com/com.zigurous.graphics/manual/shader-properties)
+- [Procedural Generation](https://docs.zigurous.com/com.zigurous.graphics/manual/procedural-generation)
+- [Material Tiling](https://docs.zigurous.com/com.zigurous.graphics/manual/material-tiling)
 - [Texture Drawers](https://docs.zigurous.com/com.zigurous.graphics/manual/texture-drawers)
+- [Extension Methods](https://docs.zigurous.com/com.zigurous.graphics/manual/extension-methods)
 
 ## Installation
 

README.md

@@ -3,7 +3,7 @@
 namespace Zigurous.Graphics
 {
     /// <summary>
-    /// Draws a texture of a checkerboard pattern.
+    /// Draws a checkerboard pattern texture.
     /// </summary>
     [CreateAssetMenu(menuName = "Zigurous/Graphics/Checkerboard Texture Drawer")]
     [HelpURL("https://docs.zigurous.com/com.zigurous.graphics/api/Zigurous.Graphics/CheckerboardTextureDrawer")]

Runtime/CheckerboardTextureDrawer.cs

@@ -3,7 +3,7 @@
 namespace Zigurous.Graphics
 {
     /// <summary>
-    /// Combines the meshes of the children of the game object into one mesh.
+    /// Combines children meshes into one mesh.
     /// </summary>
     [AddComponentMenu("Zigurous/Graphics/Combine Children Meshes")]
     [HelpURL("https://docs.zigurous.com/com.zigurous.graphics/api/Zigurous.Graphics/CombineChildrenMeshes")]
@@ -79,13 +79,11 @@ public Mesh Combine()
                     continue;
                 }
 
-                // Create a mesh combine instance
                 CombineInstance instance = new CombineInstance();
                 instance.mesh = child.mesh;
                 instance.transform = child.transform.localToWorldMatrix;
                 combine[submesh++] = instance;
 
-                // Destroy the child mesh
                 if (child.transform != this.transform)
                 {
                     if (deleteChildren) {
@@ -96,7 +94,6 @@ public Mesh Combine()
                 }
             }
 
-            // Create a new mesh from all of the combined children
             Mesh combinedMesh = new Mesh();
             combinedMesh.name = combinedMeshName;
             combinedMesh.CombineMeshes(combine, mergeSubmeshes);