[Bf-docboard-svn] bf-manual: [6939] trunk/blender_docs/manual/modeling/meshes/editing/face/shading.rst: Shade Smooth & Flat (ToDo)

[Aaron Carlisle]

Revision: 6939
          https://developer.blender.org/rBM6939
Author:   Blendify
Date:     2020-08-05 00:23:58 +0200 (Wed, 05 Aug 2020)
Log Message:
-----------
Shade Smooth & Flat (ToDo)

This is an empty page for Shading under Modeling->Meshes->Face Tools.
I recommend just removing this page all together and simply mention
on the Object Mode Shading page that the smooth and flat shading
options are available in both Object Mode and Edit Mode.
But if people want to keep this page, I did make my edit include
a note that will redirect readers to the Shading page under
Scenes & Objects->Objects. Also, I point a small but notable
difference between the Object Mode and Edit Mode Shading options.

Author @Greenmansa

Differential Revisison: https://developer.blender.org/D8274

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/meshes/editing/face/shading.rst

Modified: trunk/blender_docs/manual/modeling/meshes/editing/face/shading.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/face/shading.rst	2020-08-04 21:55:04 UTC (rev 6938)
+++ trunk/blender_docs/manual/modeling/meshes/editing/face/shading.rst	2020-08-04 22:23:58 UTC (rev 6939)
@@ -1,19 +1,48 @@
+.. _bpy.ops.mesh.face_shading:
 
 *******************
 Shade Smooth & Flat
 *******************
 
+The appearance of the mesh edges are determined to be evened out or well defined within the 3D Viewport and render.
+In Edit Mode, individual faces can be selected to determine which faces are smoothed or flattened.
+
+.. note::
+
+   Both :doc:`Shade Smooth and Flat </scene_layout/object/editing/shading>`
+   are also available in Object Mode and function the same way.
+
+
 .. _bpy.ops.mesh.faces_shade_smooth:
 
 Shade Smooth
 ============
 
-Todo.
+.. admonition:: Reference
+   :class: refbox
 
+   :Mode:      Edit Mode
+   :Menu:      :menuselection:`Face --> Shade Smooth`
 
+Using interpolated vertex normals, the mesh faces will blur at the edges and appear smooth.
+
+
 .. _bpy.ops.mesh.faces_shade_flat:
 
 Shade Flat
 ==========
 
-Todo.
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Edit Mode
+   :Menu:      :menuselection:`Face --> Shade Flat`
+
+Face normals are displayed evenly, because of this all the edges of the selected mesh will be easily visible.
+
+.. tip::
+
+   Use the :doc:`Edge Split </modeling/modifiers/generate/edge_split>`
+   modifier and :doc:`Auto Smooth </modeling/meshes/structure>`
+   within the mesh data properties to balance between smooth surfaces and sharp edges.