Revert "Revert to ecaa7f9 (wrongly pushed old stashed commits)"

This reverts commit 087f92f.

Author: NormandErwan

.config/dotnet-tools.json

@@ -3,7 +3,7 @@
   "isRoot": true,
   "tools": {
     "docfx": {
-      "version": "2.67.5",
+      "version": "2.75.3",
       "commands": [
         "docfx"
       ]

.github/workflows/unity-xref-maps.yml

@@ -13,13 +13,13 @@ jobs:
     runs-on: windows-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Install DocFX
         run: dotnet tool restore
 
       - name: Cache UnityCsReference
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: UnityCsReference
           key: unitycsreference
@@ -28,7 +28,7 @@ jobs:
         run: dotnet run
 
       - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: _site

Program.cs

@@ -14,7 +14,7 @@ namespace DocFxForUnity
     ///
     /// </summary>
     /// <remarks>
-    /// [.NET](https://dotnet.microsoft.com) >= 7.0 and [DocFX](https://dotnet.github.io/docfx/) must be installed
+    /// [.NET](https://dotnet.microsoft.com) >= 9.0 and [DocFX](https://dotnet.github.io/docfx/) must be installed
     /// on your system.
     /// </remarks>
     partial class Program
@@ -92,25 +92,34 @@ public static void Main()
                 }
 
                 Console.WriteLine($"Fixing hrefs in '{xrefMapPath}'");
-                Utils.CopyFile(GeneratedXrefMapPath, xrefMapPath);
-                var xrefMap = XrefMap.Load(xrefMapPath);
-                xrefMap.FixHrefs(apiUrl: $"https://docs.unity3d.com/{version.name}/Documentation/ScriptReference/");
-                xrefMap.Save(xrefMapPath);
+                FixHrefs(xrefMapPath, apiUrl: $"https://docs.unity3d.com/{version.name}/Documentation/ScriptReference/");
 
                 // Set the last version's xref map as the default one
                 if (version == latestVersion)
                 {
                     Console.WriteLine($"Fixing hrefs in '{DefaultXrefMapPath}'");
-                    Utils.CopyFile(GeneratedXrefMapPath, DefaultXrefMapPath);
-                    xrefMap = XrefMap.Load(DefaultXrefMapPath);
-                    xrefMap.FixHrefs(UnityApiUrl);
-                    xrefMap.Save(DefaultXrefMapPath);
+                    FixHrefs(DefaultXrefMapPath, UnityApiUrl);
                 }
 
                 Console.WriteLine("\n");
             }
         }
 
+        /// <summary>
+        /// Copies the generated xref map to <see cref="XrefMapsPath"/> and fixes its hrefs.
+        /// </summary>
+        /// <param name="xrefMapPath">Where to copy the xref map.</param>
+        /// <param name="apiUrl">The URL of the API documentation of this xref map.</param>
+        /// </summary>
+        private static void FixHrefs(string xrefMapPath, string apiUrl)
+        {
+            Utils.CopyFile(GeneratedXrefMapPath, xrefMapPath);
+
+            var xrefMap = XrefMap.Load(xrefMapPath);
+            xrefMap.FixHrefs(apiUrl);
+            xrefMap.Save(xrefMapPath);
+        }
+
         /// <summary>
         /// Returns a collection of the latest versions of a specified repository of Unity.
         /// </summary>

README.md

@@ -53,10 +53,9 @@ DocFX will set clickable all the references of the Unity API on your documentati
 
 - To run this program:
 
-    1. Install Visual Studio 2022.
-    2. Install [.NET 7.0](https://dotnet.microsoft.com/download/dotnet) SDK.
-    3. Clone this repository on your computer.
-    4. Open a terminal on the cloned repository and run:
+    1. Install [.NET 9.0](https://dotnet.microsoft.com/download/dotnet) SDK.
+    2. Clone this repository on your computer.
+    3. Open a terminal on the cloned repository and run:
 
         ```sh
         dotnet tool restore

UnityXrefMaps.csproj

@@ -2,13 +2,13 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
     <DefaultItemExcludes>$(DefaultItemExcludes);UnityCsReference*\**</DefaultItemExcludes>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="LibGit2Sharp" Version="0.26.2" />
-    <PackageReference Include="YamlDotNet" Version="12.3.1" />
+    <PackageReference Include="LibGit2Sharp" Version="0.31.0" />
+    <PackageReference Include="YamlDotNet" Version="16.3.0" />
   </ItemGroup>
 
-</Project>
+</Project>

docfx.json

@@ -8,7 +8,11 @@
       ],
       "filter": "filterConfig.yml",
       "dest": "UnityCsReference/_api",
-      "disableGitFeatures": true
+      "disableGitFeatures": true,
+      "noRestore": true,
+      "properties": {
+          "Configuration": "Debug"
+      }
     }
   ],
   "build":