Unity-Technologies · suearkinunity · Aug 14, 2024 · Aug 14, 2024 · Aug 14, 2024 · Aug 14, 2024
diff --git a/Documentation~/Arch.md b/Documentation~/Arch.md
@@ -1,4 +1,5 @@
 # Arch
+
 The basic arch shape is a curved symmetrical shape (see **A** in the image below). You can customize the basic arch shape to create tunnels, pipes, roofs, and many other objects.
 
 ![Arch shapes](images/shape-tool_arch.png)
@@ -15,11 +16,10 @@ When you customize an arch shape, keep in mind that when you change the thicknes
 
 You can customize the shape of an arch with these shape-specific properties:
 
-
-| **Property:** | **Description:**                                                                                                                                                                                                                                                                                                                         |
-|:-- |:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| __Thickness__ | Set the thickness of the arch in meters. The larger the thickness, the smaller the opening becomes. The default value is 0.1. The minimum value is 0.01.                                                                                                                                                                                 |
+| **Property** | **Description** |
+| :--- | :--- |
+| __Thickness__ | Set the thickness of the arch in meters. The larger the thickness, the smaller the opening becomes. The default value is 0.1. The minimum value is 0.01. |
 | __Sides Count__ | Set the number of sides for the arch. The more sides you use (relative to the size of the __Radius__), the smoother the arch becomes, so the closer you get to a semi-circle. Conversely, if you set this value to 2, the arch turns into a peaked roof, regardless of the radius. The default value is 5. Valid values range from 2 to 200. |
-| __Arch Circumference__ | Set the circumference of the arch in degrees. For example, an arch of 360 degrees is circular. The default value is 180. Valid values range from 1 to 360.                                                                                                                                                                               |
-| __End Caps__ | Enable this option to create faces for the ends of the arch (default). <br /><br />Disable this option if you know the ends are not visible to the camera (this is an [optimization strategy](workflow-edit-tips.md) that reduces the number of polygons that Unity has to render).                                                      |
-| **Smooth** | Enable this option to smooth the edges of the polygons. This property is enabled by default.                                                                                                                                                                                                                                             |
+| __Arch Circumference__ | Set the circumference of the arch in degrees. For example, an arch of 360 degrees is circular. The default value is 180. Valid values range from 1 to 360. |
+| __End Caps__ | Enable this option to create faces for the ends of the arch (default). <br /><br />Disable this option if you know the ends are not visible to the camera (this is an [optimization strategy](workflow-edit-tips.md) that reduces the number of polygons that Unity has to render). |
+| **Smooth** | Enable this option to smooth the edges of the polygons. This property is enabled by default. |
diff --git a/Documentation~/CenterPivot.md b/Documentation~/CenterPivot.md
@@ -1,11 +1,14 @@
-# ![Center Pivot icon](images/icons/CenterPivot.png) Center Pivot
+# Center Pivot
 
-The __Center Pivot__ action moves the pivot point for the Mesh to the center of the object’s bounds. For example, if you move a lot of vertices on one side of your Mesh, when you try to rotate the object, it rotates around a point outside of the Mesh. 
+The __Center Pivot__ action moves the pivot point for a mesh to the center of the object’s bounds. You might want to do this if you have elongated the vertices on one side of your mesh, which pushes the bounds on that side far from the original center.
 
-From the main menu, select **Tools** > **ProBuilder** > **Object** > **Center Pivot**.
+To center the pivot point:
 
-![Center Pivot example](images/CenterPivot_Example.png)
+1. Select one or more objects.
+    > **Note:** If you have multiple objects selected, each object's new pivot point is the center of that object, regardless of the position of any other object. 
+1. From the main menu, select **Tools** > **ProBuilder** > **Object** > **Center Pivot**.
+    If you are in the GameObject context, you can also right-click (macOS: **Ctrl**+click) the object and select **ProBuilder** > **Center Pivot**.
 
+![Center Pivot example. The mesh on the left side is above and to the right of its pivot. The mesh on the right has its pivot at its center.](images/CenterPivot_Example.png)
 
-
-> **Note:** If you have multiple objects selected, each object's new pivot point becomes the center of each object, regardless of the position of any other object. 
+You can also set the pivot to the center of selected edges, faces, and vertices. Refer to the [Set Pivot](SetPivot.md) action for more information.
diff --git a/Documentation~/Cone.md b/Documentation~/Cone.md
@@ -1,4 +1,5 @@
 # Cone
+
 A cone is a shape that tapers from a circular (or roughly circular) base to a point. You can adjust the smoothness.
 
 ![Cone shapes](images/shape-tool_cone.png) 
@@ -15,6 +16,6 @@ You can customize the shape of a cone with this shape-specific property:
 
 
 | **Property:** | **Description:** |
-|:-- |:-- |
+| :--- | :--- |
 | __Sides Count__ | Set the number of sides for the cone. The more sides you use, the smoother the sides of the cone become. The default value is 6. Valid values range from 3 to 64. |
 | **Smooth** | Enable this option to smooth the edges of the polygons. This property is enabled by default. |
diff --git a/Documentation~/Cube.md b/Documentation~/Cube.md
@@ -1,4 +1,5 @@
 # Cube
+
 A cube is the default shape in ProBuilder. It is a six-sided 3D square. 
 
 ![Cube shapes](images/shape-tool_cube.png)

diff --git a/Documentation~/Cylinder.md b/Documentation~/Cylinder.md
@@ -1,4 +1,5 @@
 # Cylinder
+
 A cylinder is a shape with long straight sides and two circular (or roughly circular) ends, like a tube. They have a radius and a height.
 
 ![Cylinder shapes](images/shape-tool_cylinder.png)
@@ -15,7 +16,7 @@ You can customize the shape of a cylinder with these shape-specific properties:
 
 
 | **Property:** | **Description:** |
-|:-- |:-- |
+| :--- | :--- |
 | __Sides Count__ | Set the number of sides for the cylinder. The more sides you use, the smoother the sides of the cylinder become. The default value is 6. Valid values range from 4 to 64. |
 | __Height Cuts__ | Set the number of divisions to use for the height of the cylinder. For example, a value of 3 produces 4 faces on every side of the cylinder. The default value is 0. |
 | __Smooth__ | Enable this option to smooth the edges of the polygons. This property is enabled by default. |

diff --git a/Documentation~/Door.md b/Documentation~/Door.md
@@ -1,4 +1,5 @@
 # Door
+
 The ProBuilder door shape provides a convenient door Mesh that you can set into a level wall. There are no polygons where it meets the wall, so you can place it directly into the wall.
 
 ![Door shape](images/shape-tool_door.png)
@@ -17,6 +18,6 @@ You can customize the shape of a door with these shape-specific properties:
 
 
 | **Property:** | **Description:** |
-|:-- |:-- |
+| :--- | :--- |
 | __Pediment Height__ | Set the height of the top of the door frame in meters. The default value is 0.5. The minimum value is 0.01. |
 | __Side Width__ | Set the width of the door frame on the sides in meters. The default value is 0.75. The minimum value is 0.01. |
diff --git a/Documentation~/Edge_Bevel.md b/Documentation~/Edge_Bevel.md
@@ -1,14 +1,25 @@
-# ![Bevel Edges icon](images/icons/Edge_Bevel.png) Bevel (Edge)
+# Bevel Edges
 
-The __Bevel Edge__ action splits the selected edge(s) into two edges, with a new face between.
+To create a new face from an existing face or edge, use the __Bevel Edges__ action. If you bevel a face, all its edges create a new face. If you bevel an edge, only that edge creates a new face.
 
-![Bevel 3 edges on cube](images/BevelEdges_Example.png)
+![Beveling two doors. The left door has a bevel edge, and the right door has a bevel face](images/BevelEdges_Example.png)
 
-From the main menu, select **Tools** > **ProBuilder** > **Geometry** > **Bevel Edges**.
+To bevel edges or faces:
 
-## Bevel Options
+1. In the **Tools** overlay, select the **ProBuilder** context.
+1. In the **Tool Settings** overlay, select either:
+    * The **Face** edit mode to bevel selected faces.
+    * The **Edge** edit mode to bevel selected edges.
+1. Select the face or edge to bevel. Hold **Shift** to select multiple faces or edges.
+1. Do one of the following:
+    * Right-click (macOS: **Ctrl**+click) on the selected face or edge and select **Bevel Edges**.
+    * From the main menu, select **Tools** > **ProBuilder** > **Geometry** > **Bevel Edges**.
+1. The **Bevel Edges** overlay opens and a new face is created.
 
-![Bevel Edge options](images/Edge_Bevel_props.png)
+## Bevel Edges options
 
-To change the width of the bevel, change the __Distance__ to move the newly created edge(s) from the position of the original edge(s). This becomes the width of the new face(s).
+To change the width of the new face, change the __Distance__ value, which defines the distance in meters between the original and new bevels. 
 
+The minimum width is `0.0001`. The maximum width depends on the original shape, because the new face has to fit within it.
+
+Select **Live Preview** to move the bevels as you change the distance value with the mouse. When **Live Preview** is off, the bevels update only when you release the mouse.
diff --git a/Documentation~/Edge_Bridge.md b/Documentation~/Edge_Bridge.md
@@ -1,9 +1,30 @@
-# ![Bridge Edges icon](images/icons/Edge_Bridge.png) Bridge Edges
+# Bridge Edges
 
 The __Bridge Edges__ action creates a new face between two selected edges.
 
-By default, this action can only bridge two open edges (that is, no face on the open or free side). However, you can override this; to do so, navigate to the Preferences and enable [Allow non-manifold actions](preferences.md#bridge).
-
 ![Bridge edges between two planes](images/BridgeEdges_Example.png)
 
-You can use this action with the **Alt/Opt+B** shortcut, or from the ProBuilder menu (**Tools** > **ProBuilder** > **Geometry** > **Bridge Edges**).
+To bridge edges:
+
+1. In the **Tools** overlay, select the **ProBuilder** context.
+1. In the **Tool Settings** overlay the **Edge** edit mode.
+1. Hold **Shift** to select the edges to bridge.
+1. Do one of the following:
+    * Press **Alt+B** (macOs: **Option**+**Shift**+**B**).
+    * Right-click (macOS: **Ctrl**+click) on the selected edge and select **Bridge Edges**.
+    * From the main menu, select **Tools** > **ProBuilder** > **Geometry** > **Bridge Edges**.
+
+## Open and closed edges
+
+By default, the Bridge Edges action bridges only open edges, which are edges that have only one face. This is because an edge that has more than two faces on the same plane is a non-manifold geometry, which can lead to errors.
+
+For example, if you have a door shape with an open archway and open external sides, by default you:
+
+* Can bridge the external sides, because those edges each have only one face - the front or back of the door.
+* Can't bridge the archway, because those edges have two faces each - the front (or back) and inside wall of the door.
+
+To bridge closed edges, from the main menu, go to **Unity** > **Settings** > **ProBuilder** and select **Allow non-manifold actions**.
+
+
+
+
diff --git a/Documentation~/Edge_Connect.md b/Documentation~/Edge_Connect.md
@@ -1,4 +1,4 @@
-# ![Connect Edges icon](images/icons/Edge_Connect.png) Connect Edges
+# Connect Edges
 
 The __Connect Edges__ action inserts an edge that connects the centers of each selected edge.
 

diff --git a/Documentation~/Edge_Extrude.md b/Documentation~/Edge_Extrude.md
@@ -1,4 +1,4 @@
-# ![Extrude Edges icon](images/icons/Edge_Extrude.png) Extrude Edges
+# Extrude Edges
 
 The __Extrude Edges__ action pushes a new edge out from each selected edge, connected by a new face for each edge. This action only works on open edges (that is, an edge that has no connected face on one side). However, you can override this restriction with the [Allow non-manifold actions](preferences.md#bridge) option.
 

diff --git a/Documentation~/Edge_FillHole.md b/Documentation~/Edge_FillHole.md
diff --git a/Documentation~/Edge_InsertLoop.md b/Documentation~/Edge_InsertLoop.md
@@ -1,4 +1,4 @@
-# ![Insert Edge Loop icon](images/icons/Edge_InsertLoop.png) Insert Edge Loop
+# Insert Edge Loop
 
 The __Insert Edge Loop__ action adds a new edge loop from the selected edge(s). An edge loop is a series of edges that are directly connected. They often encircle a 3D object and connect back at the origin point.
 

diff --git a/Documentation~/Edge_SetPivot.md b/Documentation~/Edge_SetPivot.md
diff --git a/Documentation~/Edge_Subdivide.md b/Documentation~/Edge_Subdivide.md
@@ -1,4 +1,4 @@
-# ![Subdivide Edge icon](images/icons/Edge_Subdivide.png) Subdivide Edges
+# Subdivide Edges
 
 The __Subdivide Edges__ action divides the selected edge(s) into multiple edges. By default, ProBuilder splits the edge in two, but in the Options window, you can set your own number of __Subdivisions__.
 

diff --git a/Documentation~/Entity_Trigger.md b/Documentation~/Entity_Trigger.md
@@ -1,4 +1,4 @@
-# ![Entity icon](images/icons/Entity_Trigger.png) Entity type actions
+# Entity type actions
 
 ProBuilder provides some default "entity" behaviors. These are MonoBehaviours that provide some commonly used functionality.
 

diff --git a/Documentation~/Face_Bevel.md b/Documentation~/Face_Bevel.md
diff --git a/Documentation~/Face_ConformNormals.md b/Documentation~/Face_ConformNormals.md
@@ -1,4 +1,4 @@
-# ![Conform Normals Icon](images/icons/Face_ConformNormals.png) Conform Normals (Faces)
+# Conform Normals (Faces)
 
 The __Conform Normals__ action sets all normals on the selected face(s) to the same relative direction.  
 

diff --git a/Documentation~/Face_Delete.md b/Documentation~/Face_Delete.md
@@ -1,4 +1,4 @@
-# ![Delete Faces icon](images/icons/Face_Delete.png) Delete Faces
+# Delete Faces
 
 The __Delete Faces__ replace deletes the selected face(s).
 

diff --git a/Documentation~/Face_Detach.md b/Documentation~/Face_Detach.md
@@ -1,4 +1,4 @@
-# ![Detach Face icon](images/icons/Face_Detach.png) Detach Faces
+# Detach Faces
 
 The __Detach Faces__ action detaches the selected face(s) from the rest of the Mesh. 
 

diff --git a/Documentation~/Face_Duplicate.md b/Documentation~/Face_Duplicate.md
@@ -1,4 +1,4 @@
-# ![Duplicate Faces icon](images/icons/Face_Duplicate.png) Duplicate Faces
+# Duplicate Faces
 
 The __Duplicate Faces__ action copies each selected face and either creates a new Mesh or leaves it in the same GameObject as a sub-Mesh, depending on the default options.