docs: docfx tweaks

Documentation~/docfx/README.md

@@ -0,0 +1,8 @@
+# Documentation
+
+1. Place `.dll` files for `Unity`, `Burst`, `Collections`, etc. in the `dlls/` folder.
+2. Navigate to the `Documentation~/docfx` folder.
+3. Build documentation using `docfx`. Optionally, if `make` is available, run `make serve` to build and open documentation in the browser.
+
+> [!NOTE]  
+> `unity-xrefmap.yml` contains cross-references between packages. This file is filled manually since there are only a few references to external definitions in the public API.

Documentation~/docfx/dlls/.gitignore

@@ -0,0 +1 @@
+*.dll

Documentation~/docfx/docfx.json

@@ -4,7 +4,8 @@
       "src": [{"src": "../../Runtime", "files": ["**/*.cs"]}],
       "dest": "api",
       "allowCompilationErrors": true,
-      "memberLayout": "separatePages"
+      "memberLayout": "separatePages",
+      "references": "dlls/*"
     }
   ],
   "build": {

Documentation~/docfx/unity-xrefmap.yml

@@ -1,24 +1,25 @@
 references:
-- uid: NativeList`1
+- uid: Unity.Collections.NativeList`1
   name: NativeList<T>
   href: https://docs.unity3d.com/Packages/[email protected]/api/Unity.Collections.NativeList-1.html
 
-- uid: NativeReference`1
+- uid: Unity.Collections.NativeReference`1
   name: NativeReference<T>
   href: https://docs.unity3d.com/Packages/[email protected]/api/Unity.Collections.NativeReference-1.html
 
-- uid: NativeArray`1
+- uid: Unity.Collections.NativeArray`1
   name: NativeArray<T>
   href: https://docs.unity3d.com/2022.3/Documentation/ScriptReference/Unity.Collections.NativeArray_1.html
 
-- uid: Allocator
+- uid: Unity.Collections.Allocator
   name: Allocator
   href: https://docs.unity3d.com/2022.3/Documentation/ScriptReference/Unity.Collections.Allocator.html
 
-- uid: JobHandle
+- uid: Unity.Jobs.JobHandle
   name: JobHandle
+  type: struct
   href: https://docs.unity3d.com/2022.3/Documentation/ScriptReference/Unity.Jobs.JobHandle.html
 
-- uid: float2
+- uid: Unity.Mathematics.float2
   name: float2
   href: https://docs.unity3d.com/Packages/[email protected]/api/Unity.Mathematics.float2.html