[Port] [6000.0] Shader Graph sample documentation structure from DOCG-7573

Author: sebastienduverne

Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Feature-Examples.md

@@ -1,7 +1,9 @@
-# Feature Examples
+# Feature Examples sample
 
 The Shader Graph Feature Examples sample content is a collection of Shader Graph assets that demonstrate how to achieve common techniques and effects in Shader Graph.  The goal of this sample pack is to help users see what is required to achieve specific effects and provide examples to make it easier for users to learn.
 
+Each sample contains notes that describe what the shader does. Most of the shaders have their core functionality in a subgraph, so you can copy and paste them into your own shader graphs.
+
 The sample content is broken into the following categories:
 
  - **Blending Masks** - these samples generate masks based on characteristics of the surface - such as height, facing angle, or distance from the camera.

Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Node-Reference.md

@@ -0,0 +1,5 @@
+# Node Reference sample
+
+This set of Shader Graph assets provides reference material for the nodes available in the Shader Graph node library.
+
+Each graph contains a description for a specific node, examples of how it can be used, and useful tips. Some example assets also show a break-down of the math that the node is doing. You can use these samples along with the documentation to learn more about the behavior of individual nodes.

Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Procedural-Patterns.md

@@ -0,0 +1,19 @@
+# Procedural Patterns sample
+
+This collection of Assets showcases various procedural techniques possible with Shader Graph. Use them directly in your Project, or edit them to create other procedural patterns.
+
+This collection includes the following patterns:
+
+* Bacteria
+* Brick
+* Dots
+* Grid
+* Herringbone
+* Hex Lattice
+* Houndstooth
+* Smooth Wave
+* Spiral
+* Stripes
+* Truchet
+* Whirl
+* Zig Zag

Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-Production-Ready.md

@@ -1,8 +1,6 @@
-# Production Ready Shaders
+# Production Ready Shaders sample
 
-The Shader Graph Production Ready Shaders sample is a collection of Shader Graph shader assets that are ready to be used out of the box or modified to suit your needs.  You can take them apart and learn from them, or just drop them directly into your project and use them as they are. The sample also includes a step-by-step tutorial for how to combine several of the shaders to create a forest stream environment.
-
-The sample content is broken into the following categories:
+The Shader Graph Production Ready Shaders sample is a collection of Shader Graph shader assets that are ready to be used out of the box or modified to suit your needs.  You can take them apart and learn from them, or just drop them directly into your project and use them as they are. The sample includes the Shader Graph versions of the HDRP and URP Lit shaders. It also includes a step-by-step tutorial for how to combine several of the shaders to create a forest stream environment.
 
 | Topic | Description   |
 |:------|:--------------|

Packages/com.unity.shadergraph/Documentation~/Shader-Graph-Sample-UGUI-Shaders.md

@@ -1,11 +1,10 @@
-# UGUI Shaders
-![The Shader Graph UGUI Shaders: A collection of Shader Graph subgraphs that serve as building blocks for building user interface elements.](images/UIToolsSample.png) 
+# UGUI Shaders sample
 
-The Shader Graph UGUI Shaders sample is a collection of Shader Graph subgraphs that serve as building blocks for building user interface elements. They speed up the process of building widgets, buttons, and backgrounds for the user interface of your project.  Using these tools, you can build dynamic, procedural UI elements that don’t require any texture memory and scale correctly for any resolution screen.
+The Shader Graph UGUI Shaders sample is a collection of Shader Graph subgraphs that you can use to build user interface elements. They speed up the process of building widgets, buttons, and backgrounds for the user interface of your project.  With these tools, you can build dynamic, procedural UI elements that don’t require any texture memory and scale correctly for any resolution screen.
 
 In addition to the subgraphs, the sample also includes example buttons, indicators, and backgrounds built using the subgraphs.  The examples show how the subgraphs function in context and help you learn how to use them.
 
-We have two main objectives with this sample set:
+This sample set covers two main objectives:
 
 
  - Demonstrate Shader Graph’s ability to create dynamic, resolution-independent user interface elements in a wide variety of shapes and styles.

Packages/com.unity.shadergraph/Documentation~/ShaderGraph-Samples-Import.md

@@ -0,0 +1,15 @@
+# Import Shader Graph samples
+
+To import a Shader Graph sample to your project:
+
+1. In the main menu, go to **Window** > **Package Management** > **Package Manager**.
+
+1. Select **Shader Graph** from the list of packages.
+
+1. In the **Samples** section, select **Import** next to a sample.
+
+To open a sample, go to the `Assets/Samples/Shader Graph/<your version>/` folder.
+
+## Additional resources
+
+* [Shader Graph samples](ShaderGraph-Samples.md)

Packages/com.unity.shadergraph/Documentation~/ShaderGraph-Samples.md

@@ -1,48 +1,12 @@
 # Shader Graph samples
 
-## Description
-
-The Shader Graph package offers sample Assets, which you can download through **Package Manager**. When you import these samples, Unity places the files in your Project's Asset folder. The files contain examples that demonstrate how to use Shader Graph features.
-
-## Add samples
-
-To add samples to your project:
-
-1. In the main menu, go to **Window** > **Package Management** > **Package Manager**.
-
-1. Select **Shader Graph** from the list of packages.
-
-1. In the **Samples** section, select **Import** next to a sample.
-
-1. Open the sample assets from the `Assets/Samples/Shader Graph/<your version>/` folder.
-
-## Available samples
-
-The following samples are currently available for Shader Graph.
-
-| Procedural Patterns |
-|:--------------------|
-|![A visual overview of Procedural Patterns](images/Patterns_Page.png) |
-| This collection of Assets showcases various procedural techniques possible with Shader Graph. Use them directly in your Project, or edit them to create other procedural patterns. The patterns in this collection are: Bacteria, Brick, Dots, Grid, Herringbone, Hex Lattice, Houndstooth, Smooth Wave, Spiral, Stripes, Truchet, Whirl, Zig Zag. |
-
-
-| Node Reference |
-|:--------------------|
-|![A visual overview of Node Reference](images/NodeReferenceSamples.png) |
-| This set of Shader Graph assets provides reference material for the nodes available in the Shader Graph node library. Each graph contains a description for a specific node, examples of how it can be used, and useful tips. Some example assets also show a break-down of the math that the node is doing. You can use these samples along with the documentation to learn more about the behavior of individual nodes. |
-
-| [Feature Examples](Shader-Graph-Sample-Feature-Examples.md) |
-|:--------------------|
-|![A visual overview of Feature Examples](images/FeatureExamplesSample.png) |
-| This is a collection of over 30 Shader Graph files.  Each file demonstrates a specific shader technique such as angle blending, triplanar projection, parallax mapping, and custom lighting. While you won’t use these shaders directly in your project, you can use them to quickly learn and understand the various techniques, and recreate them into your own work. Each file contains notes that describe what the shader is doing, and most of the shaders are set up with the core functionality contained in a subgraph that’s easy to copy and paste directly into your own shader. The sample also has extensive documentation describing each of the samples to help you learn.
-
-| [Production Ready Shaders](Shader-Graph-Sample-Production-Ready.md) |
-|:--------------------|
-|![A visual example of Production Ready Shaders](images/ProductionReadySample.png) |
-| The Shader Graph Production Ready Shaders sample is a collection of Shader Graph shader assets that are ready to be used out of the box or modified to suit your needs.  You can take them apart and learn from them, or just drop them directly into your project and use them as they are. The sample includes the Shader Graph versions of the HDRP and URP Lit shaders. It also includes a step-by-step tutorial for how to combine several of the shaders to create a forest stream environment.
-
-| [UGUI Shaders](Shader-Graph-Sample-UGUI-Shaders.md) |
-|:--------------------|
-|![A visual example of UGUI Shaders](images/UIToolsSample.png) |
-| The Shader Graph UGUI Shaders sample is a collection of Shader Graph subgraphs that you can use to build user interface elements. They speed up the process of building widgets, buttons, and backgrounds for the user interface of your project.  With these tools, you can build dynamic, procedural UI elements that don’t require any texture memory and scale correctly for any resolution screen. In addition to the subgraphs, the sample also includes example buttons, indicators, and backgrounds built with the subgraphs.  The examples show how the subgraphs function in context and help you learn how to use them.
-
+The Shader Graph package offers many different samples that demonstrate how to use Shader Graph features in various contexts.
+
+| Topic | Description |
+| :--- | :--- |
+| [Import Shader Graph samples](ShaderGraph-Samples-Import.md) | Learn how to import the Shader Graph samples to your project. |
+| [Procedural Patterns sample](Shader-Graph-Sample-Procedural-Patterns.md) | Learn how to generate patterns procedurally with Shader Graph. |
+| [Node Reference sample](Shader-Graph-Sample-Node-Reference.md) | Learn in context about the nodes from the Shader Graph [node library](Node-Library.md). |
+| [Feature Examples sample](Shader-Graph-Sample-Feature-Examples.md) | Learn about shader techniques such as angle blending, triplanar projection, parallax mapping, and custom lighting. |
+| [Production Ready Shaders sample](Shader-Graph-Sample-Production-Ready.md) | Learn how to create production ready shader graphs that emulate terrain vegetation, rock details, water effects, weather effects, and other post-processing effects. |
+| [UGUI Shaders sample](Shader-Graph-Sample-UGUI-Shaders.md) | Learn how to build user interface elements with Shader Graph. |

Packages/com.unity.shadergraph/Documentation~/TableOfContents.md

@@ -30,7 +30,7 @@
         * [Add a Sub Graph to a shader graph](Add-Sub-Graph-To-Shader-Graph.md)
         * [Add inputs and outputs to a Sub Graph](Add-Inputs-Outputs-Sub-Graph.md)
         * [Set default inputs for a Sub Graph](Sub-Graph-Default-Property-Values.md)
-        * [Change the behaviour of a Sub Graph](Change-Behaviour-Sub-Graph-Dropdown.md)
+        * [Change the behavior of a Sub Graph](Change-Behaviour-Sub-Graph-Dropdown.md)
         * [Sub Graph asset](Sub-graph-Asset.md)
     * [Sticky Notes](Sticky-Notes.md)
     * [Color Modes](Color-Modes.md)
@@ -311,6 +311,9 @@
     * [Block Nodes](Block-Node.md)
         * [Built In Blocks](Built-In-Blocks.md)
 * [Samples](ShaderGraph-Samples.md)
+    * [Import Shader Graph samples](ShaderGraph-Samples-Import.md)
+    * [Procedural Patterns](Shader-Graph-Sample-Procedural-Patterns.md)
+    * [Node Reference](Shader-Graph-Sample-Node-Reference.md)
     * [Feature Examples](Shader-Graph-Sample-Feature-Examples.md)
     * [Production Ready Shaders](Shader-Graph-Sample-Production-Ready.md)
         * [Lit Shaders](Shader-Graph-Sample-Production-Ready-Lit.md)