[Port] [6000.5] UUM-134685 Add documentation buttons to rendering debugger panel headers

Author: svc-reach-platform-support

Packages/com.unity.render-pipelines.core/Runtime/Debugging/DebugUI.Panel.cs

@@ -4,6 +4,10 @@
 
 using System;
 
+#if UNITY_EDITOR
+using UnityEditor;
+#endif
+
 #if ENABLE_RENDERING_DEBUGGER_UI
 using UnityEngine.UIElements;
 #endif
@@ -20,6 +24,8 @@ public partial class DebugUI
         public class Panel : IContainer, IComparable<Panel>
         {
 #if ENABLE_RENDERING_DEBUGGER_UI
+            private VisualElement m_HelpButton;
+
             /// <inheritdoc/>
             public VisualElement Create(DebugUI.Context context)
             {
@@ -29,9 +35,23 @@ public VisualElement Create(DebugUI.Context context)
                     name = displayName + "_Content"
                 };
 
-                var label = container.Q<Label>(className:"unity-group-box__label");
+                var label = container.Q<Label>(className: "unity-group-box__label");
                 label.AddToClassList("debug-window-header-title");
                 label.AddToClassList("debug-window-search-filter-target");
+                label.AddToClassList("debug-window-header-row");
+
+#if UNITY_EDITOR
+                if (EditorGUIUtility.isProSkin)
+                {
+                    container.AddToClassList("dark");
+                }
+
+                m_HelpButton = new UIElements.Button(() => Help.BrowseURL(documentationUrl));
+                m_HelpButton.tooltip = $"Open Reference for {displayName} debugger panel.";
+                m_HelpButton.SetEnabled(!string.IsNullOrEmpty(documentationUrl));
+                m_HelpButton.AddToClassList("debug-window-help-button");
+                label.Add(m_HelpButton);
+#endif
                 container.AddToClassList("debug-window-tab-content");
                 container.AddToClassList("unity-inspector-element");
 
@@ -98,7 +118,21 @@ public VisualElement Create(DebugUI.Context context)
             public event Action<Panel> onSetDirty = delegate { };
 
 #if UNITY_EDITOR
-            public string documentationUrl { get; set; }
+            private string m_DocumentationURL;
+
+            public string documentationUrl {
+                get => m_DocumentationURL;
+                set
+                {
+                    if (m_DocumentationURL == value)
+                        return;
+
+                    m_DocumentationURL = value;
+#if ENABLE_RENDERING_DEBUGGER_UI
+                    m_HelpButton?.SetEnabled(!string.IsNullOrEmpty(m_DocumentationURL));
+#endif
+                }
+            }
 #endif
 
             /// <summary>

Packages/com.unity.render-pipelines.core/Runtime/Debugging/Runtime UI Resources/DebugWindowCommon.uss

@@ -3,6 +3,14 @@
 
 /* Common */
 
+.debug-window-header-row {
+    flex-direction: row;
+    align-items: center;
+    justify-content: flex-end;
+    min-height: 30px;
+    width: 100%;
+}
+
 .debug-window-header-title {
     font-size: 24px;
     -unity-font-style: bold;
@@ -108,3 +116,30 @@
 .debug-window-colorfield.debug-window-table-cell>.unity-base-field__input {
     flex-grow: 0;
 }
+
+.debug-window-help-button {
+    width: 30px;
+    height: 30px;
+    padding: 0;
+    margin-top: 0;
+    margin-bottom: 0;
+    border-width: 0;
+    border-radius: 3px;
+	background-color: transparent;
+    background-size: 16px 16px;
+    background-image: resource("Icons/_Help.png");
+    align-self: flex-end;
+}
+
+.debug-window-help-button:hover {
+    background-color: var(--unity-colors-button-background-hover);
+}
+
+.dark .debug-window-help-button {
+    background-image: resource("Icons/d__Help.png");
+}
+
+.debug-window-help-button:disabled
+{
+	display: none;
+}

Packages/com.unity.render-pipelines.universal/Runtime/Debug/DebugDisplaySettingsLighting.cs

@@ -9,7 +9,6 @@ namespace UnityEngine.Rendering.Universal
     /// <summary>
     /// Lighting-related Rendering Debugger settings.
     /// </summary>
-    [URPHelpURL("features/rendering-debugger-reference", "lighting")]
     [Serializable]
     public class DebugDisplaySettingsLighting : IDebugDisplaySettingsData, ISerializedDebugDisplaySettings
     {
@@ -67,6 +66,7 @@ internal static class WidgetFactory
         }
 
         [DisplayInfo(name = "Lighting", order = 3)]
+        [URPHelpURL("features/rendering-debugger-reference", "lighting")]
         internal class SettingsPanel : DebugDisplaySettingsPanel<DebugDisplaySettingsLighting>
         {
             public SettingsPanel(DebugDisplaySettingsLighting data)