Merge pull request #387 from Unity-Technologies/uni-9224-docs-final-updates

UNI-9224: Final updates to manual documentation

Author: unitALG

CHANGELOG.md

@@ -18,6 +18,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Changes
 
 - Moved contents of warning box in `Draw Shape` tool to tooltips.
+- Updated manual documentation.
 
 ## [5.0.1] - 2021-03-09
 

Documentation~/Arch.md

@@ -1,11 +1,11 @@
 # 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.
+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)
 
-**(A)** Roof: Arch with 2 sides and increased depth
+**(A)** Roof: arch with two sides and increased depth
 
-**(B)** Wheel: Arch with increased number of sides, thickness and degrees (and no end cap)
+**(B)** Wheel: arch with increased number of sides, thickness and degrees (and no end cap)
 
 **(C)** Basic arch shape (default values)
 

Documentation~/Cone.md

@@ -1,5 +1,5 @@
 # Cone
-A cone is a shape which tapers from a circular (or roughly circular) base to a point. You can adjust the smoothness.
+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) 
 

Documentation~/Edge_Bridge.md

@@ -2,7 +2,7 @@
 
 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).
+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)
 

Documentation~/Edge_InsertLoop.md

@@ -8,6 +8,6 @@ The __Insert Edge Loop__ action adds a new edge loop from the selected edge(s).
 
 > **Tip:** You can also use this action with the **Alt/Opt+U** shortcut, or from the ProBuilder menu (**Tools** > **ProBuilder** > **Geometry** > **Insert Edge Loop**).
 
-This creates more geometry than [Connect Edges](Edge_Connect.md) or [Connect Vertices](Vert_Connect.md), but it makes the geometry cleaner. For example, if you insert an edge on a single face of a cube you get a T-junction, but if you insert an edge loop instead, you get the same geometry all around the cube, provided that the loop is only passing through quads.
+This creates more geometry than [Connect Edges](Edge_Connect.md) or [Connect Vertices](Vert_Connect.md), but it makes the geometry cleaner. For example, if you insert an edge on a single face of a cube you get a T-junction, but if you insert an edge loop instead, you get the same geometry all around the cube, if the loop is only passing through quads.
 
 You can use **Insert Edge Loop** while you edit your geometry, and then delete the extra unnecessary edges when you're finished to optimize the geometry.

Documentation~/Edge_SetPivot.md

@@ -12,3 +12,4 @@ In this example:
 * **Left panel**: The pivot point of the door is at its bottom-left corner.
 * **Middle panel**: Two edges are selected on the opposite side, so the __Set Pivot__ action changes the pivot to the center of those top edges.
 * **Right panel**: The pivot point is now at the top right, even when in Object editing mode.
+

Documentation~/Edge_Subdivide.md

@@ -1,6 +1,6 @@
 # ![Subdivide Edge icon](images/icons/Edge_Subdivide.png) Subdivide Edges
 
-The __Subdivide Edges__ action divides the selected edge(s) into multiple edges. By default, ProBuilder splits the edge in two, but you can set your own number of __Subdivisions__ in the Options window.
+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__.
 
 > **Tip:** You can also use this action with the **Alt/Opt+S** shortcut, or from the ProBuilder menu (**Tools** > **ProBuilder** > **Geometry** > **Smart Subdivide**).
 

Documentation~/Face_ConformNormals.md

@@ -2,7 +2,7 @@
 
 The __Conform Normals__ action sets all normals on the selected face(s) to the same relative direction.  
 
-ProBuilder uses the direction that most of the *selected* faces on the object are already facing.
+ProBuilder uses the direction that most of the selected faces on the object are already facing.
 
 ![Change the normals on the selected face](images/Face_ConformNormals.png) 
 

Documentation~/Face_Merge.md

@@ -6,4 +6,5 @@ The __Merge Faces__ action merges selected faces into a single face, and removes
 
 ![Material shows multiple faces become one](images/MergeFaces_Example.png)
 
-> **Caution:** Be careful when you merge two unconnected faces, because this can produce unexpected results with any texture mapping. This action can sometimes create unusual geometry artifacts, such as [vertices at T-junctions](workflow-edit-tips.md#tjoint) or [floating (winged) vertices](workflow-edit-tips.md#floatv) (that is, unused vertices sitting on an edge with no other edge passing through it). It is better to merge faces only when really necessary.
+> **Caution:** Be careful when you merge two unconnected faces, because this can produce unexpected results with any texture mapping. This action can sometimes create unusual geometry artifacts, such as [vertices at T-junctions](workflow-edit-tips.md#tjoint) or [floating (winged) vertices](workflow-edit-tips.md#floatv) (that is, unused vertices sitting on an edge with no other edge passing through it). It is better to merge faces only when necessary.
+

Documentation~/HandleAlign.md

@@ -1,6 +1,6 @@
 # ![Orientation](images/icons/HandleAlign_Local.png) Orientation
 
-The __Orientation__ action sets the orientation of Scene handles when you select [objects and elements](modes.md). Click the __Orientation__ button to switch between the three states: __Global__, __Local__, or __Normal__.
+The __Orientation__ action sets the orientation of scene handles when you select [objects and elements](modes.md). Click the __Orientation__ button to switch between the three states: __Global__, __Local__, or __Normal__.
 
 ![Handle Orientation Examples](images/HandleAlign_ExamplesWithTextAndIcons.png)
 
@@ -9,7 +9,7 @@ Depending whether you are in [text mode or icon mode](toolbar.md#buttonmode), th
 | **Icon mode:**                                             | **Text mode:**            | **Description:**                                           |
 | :----------------------------------------------------------- | ----------------------- | ------------------------------------------------------------ |
 | ![Handle Alignment Global](images/icons/HandleAlign_World.png) | **Orientation: Global** | Similar to a compass, the handle orientation is always the same, regardless of local rotation. |
-| ![Handle Alignment Local](images/icons/HandleAlign_Local.png) | **Orientation: Local**  | Similar to *left vs right*, handle orientation is relative to the object's rotation. |
+| ![Handle Alignment Local](images/icons/HandleAlign_Local.png) | **Orientation: Local**  | Similar to left vs right, handle orientation is relative to the object's rotation. |
 | ![Handle Alignment Planar](images/icons/HandleAlign_Plane.png) | **Orientation: Normal** | Special mode that aligns the handles to the exact normal direction of the selected face. |
 
 This action is available in all [edit modes](modes.md).