Migrate documentation to Docfx (#852)

* Remove doxygen config.

* Move samples to NWN.Anvil.Samples.

* Adjust namespaces.

* Add docfx config.

* Import GitHub wiki docs.

* Update code doc references to use docfx markdown.

* Add doc CI pipeline.

* Update namespace ignore rules.

Author: jhett12321

.github/workflows/docs.yml

@@ -1,23 +1,48 @@
 name: Docs
 on:
   push:
-    branches: [ main ]
+    branches:
+      - main
+      - development
+
+permissions:
+  actions: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
 jobs:
   deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          submodules: recursive
 
-      - name: Doxygen Action
-        uses: mattnotmitt/doxygen-action@v1
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
         with:
-          doxyfile-path: "./docs/Doxyfile"
-          working-directory: "."
+          global-json-file: global.json
 
-      - name: Deploy
-        uses: peaceiris/actions-gh-pages@v4
+      - name: Install DocFX
+        run: dotnet tool update -g docfx
+
+      - name: Build Docs
+        run: docfx docfx.json
+        working-directory: docs
+
+      - name: Upload Docs
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/html
-          commit_message: "Automated Commit: Update docs"
+          path: 'docs/html'
+
+      - name: Deploy Docs to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4

.gitignore

@@ -357,3 +357,4 @@ crashlytics.properties
 crashlytics-build.properties
 fabric.properties
 docs/html
+docs/api

docs/NWN.Anvil.Samples.csproj …N.Anvil.Samples/NWN.Anvil.Samples.csprojdocs/NWN.Anvil.Samples.csproj renamed to NWN.Anvil.Samples/NWN.Anvil.Samples.csproj docs/NWN.Anvil.Samples.csproj renamed to NWN.Anvil.Samples/NWN.Anvil.Samples.csproj

@@ -0,0 +1,2 @@
+<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:Boolean x:Key="/Default/CodeInspection/NamespaceProvider/NamespaceFoldersToSkip/=src_005Cmain/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

NWN.Anvil.Samples/NWN.Anvil.Samples.csproj.DotSettings

@@ -9,7 +9,7 @@
 using Anvil.API;
 using Anvil.Services;
 
-namespace NWN.Anvil.Samples
+namespace NWN.Anvil.Samples.Async
 {
   [ServiceBinding(typeof(NwTaskExamples))]
   public class NwTaskExamples

docs/samples/API/Async/NwTaskExamples.cs …les/src/main/API/Async/NwTaskExamples.csdocs/samples/API/Async/NwTaskExamples.cs renamed to NWN.Anvil.Samples/src/main/API/Async/NwTaskExamples.cs docs/samples/API/Async/NwTaskExamples.cs renamed to NWN.Anvil.Samples/src/main/API/Async/NwTaskExamples.cs

@@ -6,7 +6,7 @@
 using Anvil.Services;
 using NLog;
 
-namespace NWN.Anvil.Samples
+namespace NWN.Anvil.Samples.EngineStructures
 {
   [ServiceBinding(typeof(CassowaryExamples))]
   public class CassowaryExamples

…PI/EngineStructures/CassowaryExamples.cs …PI/EngineStructures/CassowaryExamples.csdocs/samples/API/EngineStructures/CassowaryExamples.cs renamed to NWN.Anvil.Samples/src/main/API/EngineStructures/CassowaryExamples.cs docs/samples/API/EngineStructures/CassowaryExamples.cs renamed to NWN.Anvil.Samples/src/main/API/EngineStructures/CassowaryExamples.cs

@@ -8,7 +8,7 @@
 using Anvil.API.Events;
 using Anvil.Services;
 
-namespace NWN.Anvil.Samples
+namespace NWN.Anvil.Samples.EngineStructures
 {
   [ServiceBinding(typeof(EffectExamples))]
   public class EffectExamples

…s/API/EngineStructures/EffectExamples.cs …n/API/EngineStructures/EffectExamples.csdocs/samples/API/EngineStructures/EffectExamples.cs renamed to NWN.Anvil.Samples/src/main/API/EngineStructures/EffectExamples.cs docs/samples/API/EngineStructures/EffectExamples.cs renamed to NWN.Anvil.Samples/src/main/API/EngineStructures/EffectExamples.cs

@@ -6,7 +6,7 @@
 using Anvil.API.Events;
 using Anvil.Services;
 
-namespace NWN.Anvil.Samples
+namespace NWN.Anvil.Samples.EngineStructures
 {
   [ServiceBinding(typeof(ItemPropertyExamples))]
   public class ItemPropertyExamples

…EngineStructures/ItemPropertyExamples.cs …EngineStructures/ItemPropertyExamples.csdocs/samples/API/EngineStructures/ItemPropertyExamples.cs renamed to NWN.Anvil.Samples/src/main/API/EngineStructures/ItemPropertyExamples.cs docs/samples/API/EngineStructures/ItemPropertyExamples.cs renamed to NWN.Anvil.Samples/src/main/API/EngineStructures/ItemPropertyExamples.cs

@@ -8,7 +8,7 @@
 
 // The "ServiceBinding" attribute indicates this class should be created on start, and available to other classes as a dependency "MyScriptHandler"
 // You can also bind yourself to an interface or base class. The system also supports multiple bindings.
-namespace NWN.Anvil.Samples
+namespace NWN.Anvil.Samples.Services
 {
   [ServiceBinding(typeof(BasicScriptHandler))]
   public class BasicScriptHandler

…s/samples/Services/BasicScriptHandler.cs …/src/main/Services/BasicScriptHandler.csdocs/samples/Services/BasicScriptHandler.cs renamed to NWN.Anvil.Samples/src/main/Services/BasicScriptHandler.cs docs/samples/Services/BasicScriptHandler.cs renamed to NWN.Anvil.Samples/src/main/Services/BasicScriptHandler.cs

@@ -8,7 +8,7 @@
 using Anvil.API.Events;
 using Anvil.Services;
 
-namespace NWN.Anvil.Samples
+namespace NWN.Anvil.Samples.Services
 {
   // Our base chat command interface...
   public interface IChatCommand