Fix DocFX API fix: Reference 404 and add documentation validation to CI (#71)

Author: Copilot

.github/workflows/ci.yml

@@ -40,6 +40,14 @@ jobs:
       - name: Build (Release)
         run: dotnet build PatternKit.slnx --configuration Release --no-restore /p:ContinuousIntegrationBuild=true
 
+      - name: Install DocFX
+        run: dotnet tool update -g docfx
+
+      - name: Build Documentation
+        run: |
+          docfx metadata docs/docfx.json
+          docfx build docs/docfx.json
+
       - name: Test with coverage
         run: |
           dotnet test PatternKit.slnx \

.github/workflows/docs.yml

@@ -30,7 +30,8 @@ jobs:
 
       - run: dotnet tool update -g docfx
       - run: dotnet build -c Release
-      - run: docfx docs/docfx.json
+      - run: docfx metadata docs/docfx.json
+      - run: docfx build docs/docfx.json
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

.gitignore

@@ -5,6 +5,8 @@ riderModule.iml
 /_ReSharper.Caches/
 .idea/
 _site/
-api/
+# Exclude generated API metadata files but keep index.md
+docs/api/*.yml
+docs/api/.manifest
 *.user
 TestResults/

docs/api/index.md

@@ -0,0 +1,27 @@
+# API Reference
+
+Welcome to the PatternKit API reference documentation.
+
+PatternKit provides fluent, modern implementations of classic design patterns for .NET 9+.
+
+## Namespaces
+
+Browse the API documentation by namespace:
+
+- **PatternKit.Behavioral** - Behavioral patterns (Strategy, Chain, Iterator, Visitor, etc.)
+- **PatternKit.Creational** - Creational patterns (Factory, Builder, Prototype, Singleton)
+- **PatternKit.Structural** - Structural patterns (Decorator, Proxy, Facade, Adapter, etc.)
+- **PatternKit.Generators** - Source generators for reducing boilerplate
+
+## Getting Started
+
+If you're new to PatternKit, check out:
+
+- [Home](../index.md) - Overview and quick start guide
+- [Patterns](../patterns/) - Pattern documentation and examples
+- [Generators](../generators/) - Source generator guides
+
+## Additional Resources
+
+- [GitHub Repository](https://github.com/JerrettDavis/PatternKit)
+- [NuGet Package](https://www.nuget.org/packages/PatternKit)

docs/docfx.json

@@ -1,6 +1,25 @@
 {
   "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json",
-  "metadata": [],
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/PatternKit.Core/**.csproj",
+            "src/PatternKit.Generators.Abstractions/**.csproj"
+          ],
+          "src": ".."
+        }
+      ],
+      "dest": "api",
+      "includePrivateMembers": false,
+      "disableGitFeatures": false,
+      "disableDefaultFilter": false,
+      "properties": {
+        "TargetFramework": "net9.0"
+      }
+    }
+  ],
   "build": {
     "content": [
       {