applied changes required by doc tooling 3x

Author: ritamerkl

Assets/Tests/InputSystem/DocumentationBasedAPIVerficationTests.cs

@@ -44,6 +44,14 @@ public void OneTimeSetup()
         Directory.CreateDirectory(docsPath);
         var inputSystemPackageInfo = UnityEditor.PackageManager.PackageInfo.FindForAssetPath("Packages/com.unity.inputsystem");
 
+        // PMDT 3.x generates API docs from .csproj files rather than compiled assemblies.
+        // On CI (fresh clone, no IDE installed), SyncAll() is a no-op and no .sln/.csproj files
+        // exist yet. Force solution generation via reflection since SyncVS is internal in Unity 6.x.
+        var syncVsType = Type.GetType("UnityEditor.SyncVS, UnityEditor");
+        syncVsType?.GetMethod("SyncSolution",
+            BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static)
+            ?.Invoke(null, null);
+
 #if HAVE_DOCTOOLS_INSTALLED
         (_documentationBuilderLogs, _docsFolder) = Documentation.Instance.GenerateEx(inputSystemPackageInfo, InputSystem.version.ToString(), docsPath);
         _docsFolder = Path.Combine(docsPath, _docsFolder);
@@ -394,6 +402,14 @@ private static void CheckHTMLFileLinkConsistency(string htmlFile, List<string> u
             if (link.StartsWith("https://"))
                 continue;
 
+            // javascript: URIs are used by the PMDT 3.x HTML theme for collapsible navigation elements
+            if (link.StartsWith("javascript:"))
+                continue;
+
+            // xref: URIs are unresolved DocFX cross-references to types outside this package
+            if (link.StartsWith("xref:"))
+                continue;
+
             if (link == "#top")
                 continue;
 

Packages/com.unity.inputsystem/Documentation~/config.json

@@ -1,7 +1,8 @@
 {
     "hideGlobalNamespace": true,
+    "DefineConstants": "UNITY_INPUT_SYSTEM_PROJECT_WIDE_ACTIONS",
     "xref": [
         "com.unity.xr.openxr",
         "com.unity.xr.interaction.toolkit"
     ]
-}
+}

Packages/com.unity.inputsystem/Documentation~/projectMetadata.json

@@ -2904,8 +2904,8 @@ public static event Action onSettingsChange
         /// <example>
         /// <code>
         /// InputSystem.customBindingPathValidators += (string bindingPath) => {
-        ///     // Mark <Gamepad> bindings with a warning
-        ///     if (!bindingPath.StartsWith("<Gamepad>"))
+        ///     // Mark &lt;Gamepad&gt; bindings with a warning
+        ///     if (!bindingPath.StartsWith("&lt;Gamepad&gt;"))
         ///         return null;
         ///
         ///     // Draw the warning information in the Binding Properties panel