[Bf-docboard-svn] bf-manual: [9478] branches/blender-3.3-release/blender_docs/manual/scene_layout/object/editing/shading.rst: Mesh: Add Auto Smooth option to Shade Smooth operator

[Aaron Carlisle]

Revision: 9478
          https://developer.blender.org/rBM9478
Author:   Blendify
Date:     2022-08-14 04:52:00 +0200 (Sun, 14 Aug 2022)
Log Message:
-----------
Mesh: Add Auto Smooth option to Shade Smooth operator

rBeef98e66cf9e726ae262a7bb7f734d01b9577812

Modified Paths:
--------------
    branches/blender-3.3-release/blender_docs/manual/scene_layout/object/editing/shading.rst

Modified: branches/blender-3.3-release/blender_docs/manual/scene_layout/object/editing/shading.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/scene_layout/object/editing/shading.rst	2022-08-14 02:22:02 UTC (rev 9477)
+++ branches/blender-3.3-release/blender_docs/manual/scene_layout/object/editing/shading.rst	2022-08-14 02:52:00 UTC (rev 9478)
@@ -25,13 +25,37 @@
 
 Select the *Shade Flat* item in the *Object* menu
 to revert the shading back (normals will be constant)
-to that shown in the first image above.
+to that shown in the first image below.
 
-.. seealso::
+.. list-table:: Example mesh flat (left) and smooth-shaded (right).
+   `Sample blend-file <https://wiki.blender.org/wiki/File:25-manual-meshsmooth-example.blend>`__.
 
-   The :ref:`Auto Smooth <auto-smooth>` mesh property.
+   * - .. figure:: /images/scene-layout_object_editing_shading_example-flat.png
+          :width: 200px
 
+     - .. figure:: /images/scene-layout_object_editing_shading_example-smooth.png
+          :width: 200px
 
+
+Shade Auto Smooth
+=================
+
+.. reference::
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Shade Smooth`
+
+Automatically applies smooth shading to faces with a defined shallow angle and all other faces are sharp.
+This method works great for objects with both sharp and smooth areas.
+
+Selecting the *Shade Flat* will revert the shading back to flat;
+additionally, pressing *Shade Smooth* will disable all flat normals,
+making the entire object appear smooth again.
+
+When this operator is used it enables the :ref:`Auto Smooth <bpy.types.Mesh.use_auto_smooth>` property.
+See :ref:`modeling_meshes_normals_sharp_edge` for more details.
+
+
 .. _bpy.ops.object.shade_flat:
 
 Shade Flat
@@ -48,12 +72,3 @@
 you may notice that these polygons appear as a series of small, flat faces.
 Sometimes this is a desirable effect for hard surfaces,
 but for organic surfaces you usually want your objects to look smooth.
-
-.. list-table:: Example mesh flat (left) and smooth-shaded (right).
-   `Sample blend-file <https://wiki.blender.org/wiki/File:25-manual-meshsmooth-example.blend>`__.
-
-   * - .. figure:: /images/scene-layout_object_editing_shading_example-flat.png
-          :width: 200px
-
-     - .. figure:: /images/scene-layout_object_editing_shading_example-smooth.png
-          :width: 200px