Unity-Technologies · suearkinunity · Sep 4, 2024 · Aug 28, 2024 · Aug 28, 2024 · Aug 29, 2024
diff --git a/Documentation~/Edge_FillHole.md b/Documentation~/Edge_FillHole.md
diff --git a/Documentation~/FillHole.md b/Documentation~/FillHole.md
@@ -0,0 +1,21 @@
+# Fill Hole
+
+In ProBuilder, a hole is a missing face. The **Fill Hole** action creates a face between existing edges or vertices that touch the selected hole.
+
+> **Tip:** You don't need to select all edges or vertices around a hole. Selecting only one edge or vertex is enough to fill the hole.
+
+To fill a hole:
+
+1. In the **Tools** overlay, select the **ProBuilder** context.
+1. In the **Tool Settings** overlay, select either:
+    * The **Vertex** edit mode.
+    * The **Edge** edit mode.
+1. Select an edge or vertex along the hole. <!--the tooltip on Fille Entire Hole says you can get all the holes at once by not selecting anything - same as Select Hole - but I can't get the Fill Hole option clickable without selecting something-->
+1. Do one of the following:
+    * Right-click (macOS: **Ctrl**+click) select **Fill Hole**.
+    * From the main menu, select **Tools** > **ProBuilder** > **Geometry** > **Select Hole**.
+1. The **Fill Hole Options** overlay opens. 
+    By default, ProBuilder fills the entire hole. If you want to fill only part of the hole, disable the **Fill Entire Hole** option and select the edges you want to build along. 
+    For example, if you have a missing quad, and select to adjacent edges, ProBuilder creates a triangular polygon that covers half of the hole.
+
+![On the right is a shape with a hole. On the left, the hole is filled.](images/FillHole_Example.png)
diff --git a/Documentation~/Selection_EdgeLoopRing.md b/Documentation~/Selection_EdgeLoopRing.md
@@ -0,0 +1,23 @@
+# Select Edge Loop or Edge Ring
+
+To add edges to a selection, you can use the **Select Edge Loop** or **Select Edge Ring** actions:
+
+* The **Select Edge Loop** action adds edges that touch your selected edge.
+
+    ![On the left, a single edge is selected. On the right, all touching edges are selected, forming a closed loop.](images/Selection_LoopExample.png)
+
+* The **Select Edge Ring** action adds edges that touch the same faces as your selected edge, but that don't touch the selected edge itself.
+
+    ![On the left, a single edge is selected along two faces. On the right, all edges that touch the same two faces are selected.](images/Selection_RingExample.png)
+
+To grow an edge selection:
+
+1. In the **Tools** overlay, select the **ProBuilder** context.
+1. In the **Tool Settings** overlay, select the **Edge** edit mode.
+1. Select an edge.
+1. Do one of the following:
+    * Right-click (macOS: **Ctrl**+click) and click **Select** > **Select Edge Loop** or **Select Edge Ring**.
+    * From the main menu, select **Tools** > **ProBuilder** > **Selection** >  **Select Loop** or **Select Ring** (these option names don't include the word "Edge").
+1. The **Select Edge Ring** or **Select Edge Loop** overlay opens and the selection is expanded to match the default settings. 
+    The **Iterative Selection** option is available for both actions. When you select it, the selection grows to include edges that are next to the edges it just added, and not just the edges next to the original selection.
+
diff --git a/Documentation~/Selection_FaceLoopRing.md b/Documentation~/Selection_FaceLoopRing.md
@@ -0,0 +1,24 @@
+# Select Face Loop or Face Ring
+
+To add touching faces to a face you've selected, you can use the **Select Face Loop** or **Select Face Ring** actions:
+
+* The **Select Face Loop** action follows the z-axis.
+
+    ![On the left, a single face is selected. On the right, the selection grows along the z-axis.](images/SelectFaceLoop_Example.png)
+
+* The **Select Face Ring** action follows the x-axis.
+
+    ![On the left, a single face is selected. On the right, the selection grows along the x-axis.](images/SelectFaceRing_Example.png)
+
+> **Note:** Both actions work only on quad faces (each face has four sides).
+
+To grow a face selection:
+
+1. In the **Tools** overlay, select the **ProBuilder** context.
+1. In the **Tool Settings** overlay, select the **Face** edit mode.
+1. Select a face.
+1. Do one of the following:
+    * Right-click (macOS: **Ctrl**+click) and click **Select** > **ProBuilder Slection** **Select Face Loop** or **Select Face Ring**.
+    * From the main menu, select **Tools** > **ProBuilder** > **Selection** >  **Select Loop** or **Select Ring** (these option names don't include the word "Face").
+1. The selection is expanded. There are no settings to adjust.
+
diff --git a/Documentation~/Selection_Grow.md b/Documentation~/Selection_Grow.md
@@ -8,7 +8,7 @@ To expand the selection:
 1. In the **Tool Settings** overlay, select an edit mode. All three modes support this action.
 1. Select a face, edge, or vertex.
 1. Do one of the following:
-    * Right-click (macOS: **Ctrl**+click) and click **Select** > **Grow Selection**.
+    * Right-click (macOS: **Ctrl**+click) and click **Select** > **ProBuilder Select** > **Grow Selection**.
     * From the main menu, select **Tools** > **ProBuilder** > **Selection** > **Grow Selection**.
 1. The **Grow Selection** overlay opens and the selection is expanded to match the default settings.
 

diff --git a/Documentation~/Selection_Loop_Edge.md b/Documentation~/Selection_Loop_Edge.md
diff --git a/Documentation~/Selection_Loop_Face.md b/Documentation~/Selection_Loop_Face.md
diff --git a/Documentation~/Selection_SelectHole.md b/Documentation~/Selection_SelectHole.md
@@ -1,11 +1,22 @@
-# ![Select Hole icon](images/icons/Selection_SelectHole.png) Select Holes
+# Select Hole
 
-The __Select Holes__ action selects all elements along the selected open vertex or edge. A hole is like a removed face. This action is a useful shortcut for selecting all the edges around a missing face.
+In ProBuilder, a hole is a missing face. The **Select Hole** action is a version of Grow Selection that selects all elements along an open vertex or edge. 
 
-If you have no elements selected, this action automatically selects all holes in the selected object.
+> **Tip:** To create a face from the hole, refer to [Fill Hole](FillHole.md).
 
-![Start with one edge selected, grow selection around hole](images/Example_SelectHole.png)
+<!--fill hole is currently two pages; I will not allow that to stand-->
 
-This action also tells you how many holes exist in the Mesh. It is only available in the [vertex and edge modes](modes.md).
+To select a hole:
+
+1. In the **Tools** overlay, select the **ProBuilder** context.
+1. In the **Tool Settings** overlay, select either:
+    * The **Vertex** edit mode.
+    * The **Edge** edit mode.
+1. Select an edge or vertex along a hole. To select all the holes in the mesh at once, don't select any vertex or edges.
+1. Do one of the following:
+    * Right-click (macOS: **Ctrl**+click) select **ProBuilder Select** > **Select Hole**.
+    * From the main menu, select **Tools** > **ProBuilder** > **Selection** > **Select Hole**.
+1. All the edges or vertexes along the hole are selected.
+
+![On the left is a mesh with a single selected edge along a missing face. On the right, the same mesh has all edges around the missing face selected.](images/Example_SelectHole.png)
 
-From the main menu, select **Tools** > **ProBuilder** > **Selection** > **Select Hole**.
diff --git a/Documentation~/TableOfContents.md b/Documentation~/TableOfContents.md
@@ -19,61 +19,58 @@
 	* [Common editing tasks](workflow-edit-tasks)
 	* [Modeling tips for novices](workflow-edit-tips)
 	* [Setting vertex colors](workflow-vertexcolors)
-	* [Selection options reference](selection-ref)
+	* [Selection options reference](selection_ref)
 	    * [Grow Selection](Selection_Grow)
 		* [Select Hole](Selection_SelectHole)
-	    * [Select Loop (in Edge Selection mode)](Selection_Loop_Edge)
-    	* [Select Loop (in Face Selection mode)](Selection_Loop_Face)
-	    * [Select Material](Selection_SelectByMaterial)
-	    * [Select Ring (in Edge Selection mode](Selection_Ring_Edge)
-	    * [Select Ring (in Face Selection mode](Selection_Ring_Face)
-	    * [Select Vertex Color](Selection_SelectByVertexColor)
-    	* [Shrink Selection](Selection_Shrink)
+		* [Select Face Loop or Face Ring](Selection_FaceLoopRing)
+		* [Select Edge Loop or Edge Ring](Selection_EdgeLoopRing)
+		* [Select Material](Selection_SelectByMaterial)
+		* [Select Vertex Color](Selection_SelectByVertexColor)
+		* [Shrink Selection](Selection_Shrink)
 		* [Select Path](SelectPath)
 	* [Interaction options reference](interaction-ref)
-    	* [Rect](Selection_Rect_Intersect)
-	    * [Toggle Handle Orientation](HandleAlign)
-    	* [Toggle Select Back Faces](Selection_SelectHidden)
-    	* [Toggle X Ray](Toggle_X_Ray)
+	    * [Rect](Selection_Rect_Intersect)
+		* [Toggle Handle Orientation](HandleAlign)
+		* [Toggle Select Back Faces](Selection_SelectHidden)
+		* [Toggle X Ray](Toggle_X_Ray)
 	* [Object options reference](object-ref)
-		* [Center Pivot](CenterPivot)
-    	* [Conform Objects Normals](Object_ConformNormals)
-	    * [Flip Normals](Object_FlipNormals)
-    	* [Freeze Transform](Freeze_Transform)
-    	* [Merge Objects](Object_Merge)
-    	* [Mirror Objects](Object_Mirror)
-    	* [ProBuilderize](Object_ProBuilderize)
+	    * [Center Pivot](CenterPivot)
+		* [Conform Objects Normals](Object_ConformNormals)
+		* [Flip Normals](Object_FlipNormals)
+		* [Freeze Transform](Freeze_Transform)
+		* [Merge Objects](Object_Merge)
+		* [Mirror Objects](Object_Mirror)
+		* [ProBuilderize](Object_ProBuilderize)
 		    * [ProBuilder MeshFilter component](ProBuilderMesh)
 		* [Set Collider](Entity_Trigger#Collider)
-    	* [Set Trigger](Entity_Trigger)
-    	* [Subdivide Object](Object_Subdivide)
-    	* [Triangulate (Object)](Object_Triangulate)
-	* [Geometry options reference](geo-ref)
+		* [Set Trigger](Entity_Trigger)
+		* [Subdivide Object](Object_Subdivide)
+		* [Triangulate (Object)](Object_Triangulate)
+	* [Geometry options reference](geo_ref)
 	    * [Bevel Edges](Edge_Bevel)
-    	* [Bridge Edges](Edge_Bridge)
-    	* [Collapse Vertices](Vert_Collapse)
-    	* [Conform Face Normals](Face_ConformNormals)
+		* [Bridge Edges](Edge_Bridge)
+		* [Collapse Vertices](Vert_Collapse)
+		* [Conform Face Normals](Face_ConformNormals)
 		* [Delete Faces](Face_Delete)
-    	* [Detach Faces](Face_Detach)
-    	* [Duplicate Faces](Face_Duplicate)
-    	* [Export](Object_Export)
-        * [Extrude Edges](Edge_Extrude)
-	    * [Extrude Faces](Face_Extrude)
-        * [Fill Hole (Edges)](Edge_FillHole)
-	    * [Fill Hole (Vertices)](Vert_FillHole)
+		* [Detach Faces](Face_Detach)
+		* [Duplicate Faces](Face_Duplicate)
+		* [Export](Object_Export)
+		* [Extrude Edges](Edge_Extrude)
+		* [Extrude Faces](Face_Extrude)
+		* [Fill Hole)](FillHole)
 		* [Flip Face Edge](Face_FlipTri)
-	    * [Flip Face Normals](Face_FlipNormals)
-	    * [Insert Edge Loop](Edge_InsertLoop)
+		* [Flip Face Normals](Face_FlipNormals)
+		* [Insert Edge Loop](Edge_InsertLoop)
 		* [Merge Faces](Face_Merge)
-    	* [Offset Elements](Offset_Elements)
-    	* [Set Pivot To Selection](SetPivot)
-        * [Smart Connect (Connect Edges)](Edge_Connect)
+		* [Offset Elements](Offset_Elements)
+		* [Set Pivot To Selection](SetPivot)
+		* [Smart Connect (Connect Edges)](Edge_Connect)
 		* [Smart Connect (Connect Vertices)](Vert_Connect)
 		* [Smart Subdivide (Subdivide Edges)](Edge_Subdivide)
-	    * [Smart Subdivide (Subdivide Faces)](Face_Subdivide)
+		* [Smart Subdivide (Subdivide Faces)](Face_Subdivide)
 		* [Split Vertices](Vert_Split)
 		* [Triangulate Faces](Face_Triangulate)
-    	* [Weld Vertices](Vert_Weld)
+		* [Weld Vertices](Vert_Weld)
 * [Materials, Shaders, Textures, and UVs](workflow-texture-mapping)
 	* [Creating and applying Materials](workflow-materials)
 	* [Mapping Textures with UVs](workflow-uvs)

diff --git a/Documentation~/geo_ref.md b/Documentation~/geo_ref.md
@@ -22,8 +22,7 @@ These actions are available:
 | [Export](Object_Export.md) | x | | | |
 | [Extrude Edges](Edge_Extrude.md) | | | x | |
 | [Extrude Faces](Face_Extrude.md) | | | | x |
-| [Fill Hole](Edge_FillHole.md) (Edges) | | | x | |
-| [Fill Hole](Vert_FillHole.md) (Vertices) | | x | | |
+| [Fill Hole](FillHole.md) | | x | x | |
 | [Flip Face Edge](Face_FlipTri.md)  | | | | x |
 | [Flip Face Normals](Face_FlipNormals.md) | | | | x |
 | [Insert Edge Loop](Edge_InsertLoop.md)  | | | | |
@@ -43,7 +42,6 @@ These actions are available:
 The Editor:
 
 * Has only one extrude - I should merge them
-* Has only one fill hole - I should merge them
 * Doesn't have inset - it's just a way to use extrude, so why is it treated as an action?
 * Doesn't have Shift
 * Doesn't have Lightmap UVs

diff --git a/Documentation~/selection_ref.md b/Documentation~/selection_ref.md
@@ -16,11 +16,11 @@ These options are never available in the GameObject tool context.
 | ---- | ---- | ---- | ---- |
 | [Grow Selection](Selection_Grow.md) | x | x | x |
 | [Select Hole](Selection_SelectHole.md) | x | x | |
-| [Select Loop (in Edge Selection mode)](Selection_Loop_Edge.md) | | x | |
-| [Select Loop (in Face Selection mode)](Selection_Loop_Face.md) | | | x |
+| [Select Face Loop](Selection_FaceLoopRing.md) | | | x |
+| [Select Face Ring](Selection_FaceLoopRing.md) | | | x |
+| [Select Edge Loop](Selection_EdgeLoopRing.md) | | x | |
+| [Select Edge Ring](Selection_EdgeLoopRing.md) | | x | |
 | [Select Material](Selection_SelectByMaterial.md) | | | x |
-| [Select Ring (in Edge Selection mode)](Selection_Ring_Edge.md) | | x | |
-| [Select Ring (in Face Selection mode)](Selection_Ring_Face.md) | | | x |
 | [Select Vertex Color](Selection_SelectByVertexColor.md) | x | x | x |
 | [Shrink Selection](Selection_Shrink.md) | | x | x | x |