[2023.3] Improve build time using the URP Config Package and some small updates

- Added `Reduce build time` section in [Forward+ page](https://github.cds.internal.unity3d.com/unity/unity/blob/graphics/urp/configpackage-doc/Packages/com.unity.render-pipelines.universal/Documentation%7E/rendering/forward-plus-rendering-path.md#reduce-build-time)
- Added links in [urp-optimization](https://github.cds.internal.unity3d.com/unity/unity/blob/graphics/urp/configpackage-doc/Packages/com.unity.render-pipelines.universal/Documentation~/urp-optimization.md)
- Added build time issue in [known issues](https://github.cds.internal.unity3d.com/unity/unity/blob/graphics/urp/configpackage-doc/Packages/com.unity.render-pipelines.universal/Documentation~/known-issues.md)
- Updated the [creating-a-new-project-with-urp](https://github.cds.internal.unity3d.com/unity/unity/blob/graphics/urp/configpackage-doc/Packages/com.unity.render-pipelines.universal/Documentation~/creating-a-new-project-with-urp.md) with the new URP 3D sample info

Co-authored with @oleksandr-kokoshyn 
Related [slack thread](https://unity.slack.com/archives/C02N6JRGRST/p1704274494440809?thread_ts=1701700145.431409&cid=C02N6JRGRST)
JIRA: https://jira.unity3d.com/browse/DOCG-4931

Author: cinight

Packages/com.unity.render-pipelines.universal/Documentation~/Images/AssetShots/Beauty/Template.png

@@ -6,7 +6,7 @@
   * [Feature list](urp-feature-list.md)
   * [Feature Comparison with the Built-in Render Pipeline](universalrp-builtin-feature-comparison.md)
 * [Getting started](InstallingAndConfiguringURP.md)
-  * [Create a Project from a Template](creating-a-new-project-with-urp.md)
+  * [Create a Project with 3D Sample Scenes](creating-a-new-project-with-urp.md)
   * [Install URP into an existing Project](InstallURPIntoAProject.md)
   * [Package samples](package-samples.md)
     * [URP Package Samples](package-sample-urp-package-samples.md)

Packages/com.unity.render-pipelines.universal/Documentation~/TableOfContents.md

@@ -1,13 +1,13 @@
-# Using the Universal Render Pipeline in a new Project
+# Create a project with 3D Sample Scenes
 
-![URP Template](Images/AssetShots/Beauty/Template.png)
+![URP 3D Sample](Images/AssetShots/Beauty/Template.png)
 
-If you want to use the Universal Render Pipeline (URP) in a new Project, you can create a new Project using a Template.
-
-To create a URP Project using a Template:
+To explore various features of the Universal Render Pipeline (URP), create a new Project with 3D Sample Scenes.
 
 1. Open the Unity Hub.
-2. On the Home page, click **New** to start a new Project. The Templates popup appears.
-3. Select the Universal Render Pipeline Template.
-4. Click **Create**. Unity creates a new Project for you. The new Project has URP installed and configured, and includes some example content that demonstrates URP's functionality.
-5. In the Project window, navigate to the _Assets_ folder, and select the **Readme** Asset. Unity will show information about the Project in the Inspector window.
+
+2. On the Home page, click **New project** to start a new Project.
+
+3. In the **Sample** tab, select **3D Sample Scenes (URP)**.
+
+4. Click **Create project**. Unity creates a new project with URP installed and configured, and includes example content that demonstrates URP features.

Packages/com.unity.render-pipelines.universal/Documentation~/creating-a-new-project-with-urp.md

@@ -2,6 +2,18 @@
 
 This page contains information on known issues you may encounter when using URP.
 
+## Long build times when using the Forward+ Rendering Path
+
+Due to the wide variety of use cases, target platforms, renderers, and features used in projects, certain URP configurations can result in a large number of shader variants. That can lead to long compilation times.
+
+Long shader compilation time affects both player build time and the time for a scene to render in the Editor.
+
+The per-camera visible light limit value affects the compilation time for each **Lit** and **Complex Lit** shader variant. In the Forward+ Rendering Path, on desktop platforms, that limit is 256.
+
+Refer to the following page to learn how to reduce the build time in the Forward+ Rendering Path by reducing the maximum number of visible lights:
+
+* [Reduce build time in Forward+ Rendering Path](rendering/forward-plus-rendering-path.md#reduce-build-time)
+
 ## When importing the URP package samples, Unity does not set the necessary URP asset in Quality > Render Pipeline Asset<a name="urp-samples-known-issue-1"></a>
 
 When importing the URP package samples, Unity does not set the necessary URP asset in **Quality** > **Render Pipeline Asset**, and certain sample rendering effects do not work.

Packages/com.unity.render-pipelines.universal/Documentation~/known-issues.md

@@ -32,3 +32,39 @@ When you set the Rendering Path to Forward+, Unity ignores the values in the fol
 ## Limitations
 
 The Forward+ Rendering Path has no limitations compared with the Forward Rendering Path.
+
+## Reduce build time
+
+Due to the wide variety of use cases, target platforms, renderers, and features used in projects, certain URP configurations can result in a large number of shader variants. That can lead to long compilation times.
+
+Long shader compilation time affects both player build time and the time for a scene to render in the Editor.
+
+The per-camera visible light limit value affects the compilation time for each **Lit** and **Complex Lit** shader variant. In the Forward+ Rendering Path, on desktop platforms, that limit is 256.
+
+This section describes how to reduce the shader compilation time by changing the default maximum per-camera visible light count.
+
+### Change the maximum number of visible lights
+
+> [!NOTE]
+> This instruction describes a workaround for a limitation in the URP design. This limitation will be mitigated in one of the future Unity versions.
+
+The [Universal Render Pipeline Config package](../URP-Config-Package.md) contains the settings that define the number of maximum visible light. The following instructions describe how to change those settings.
+
+> [!NOTE]
+> If you upgrade the Unity version of your project, repeat this procedure.
+
+1. In your project folder, copy the **URP Config Package** folder from `/Library/PackageCache/com.unity.render-pipelines.universal-config` to `/Packages/com.unity.render-pipelines.universal-config`.
+
+2. Open the file `/com.unity.render-pipelines.universal-config/Runtime/ShaderConfig.cs.hlsl`.
+
+    The file contains multiple definitions that start with `MAX_VISIBLE_LIGHT_COUNT` and end with the target platform name. Change the value in brackets to a suitable maximum in-frustum per-camera light count for your project, for example, `MAX_VISIBLE_LIGHT_COUNT_DESKTOP (32)`.
+
+    For the **Forward+** Rendering Path, the value includes the Main Light. For the **Forward** Rendering Path, the value does not include the Main Light.
+
+3. Open the file `/com.unity.render-pipelines.universal-config/Runtime/ShaderConfig.cs`.
+
+    The file contains multiple definitions that start with `k_MaxVisibleLightCount` and end with the platform name. Change the value so that it matches the value set in the `ShaderConfig.cs.hlsl` file, for example `k_MaxVisibleLightCountDesktop = 32;`.
+
+4. Save the edited files and restart the Unity Editor. Unity automatically configures your project and shaders to use the new configuration.
+
+Now the Player build time should be shorter due to the reduced compilation time for each shader variant.

Packages/com.unity.render-pipelines.universal/Documentation~/rendering/forward-plus-rendering-path.md

@@ -5,3 +5,9 @@ This section contains information related to optimization and debugging.
 This section contains the following topics:
 
 * [Rendering Debugger](features/rendering-debugger.md)
+
+* [Add controls to the Rendering Debugger](features/rendering-debugger-add-controls.md)
+
+* [Optimize for better performance](optimize-for-better-performance.md)
+
+* [Update Quality Setting Presets for URP](birp-onboarding/quality-presets.md)