docs: refine DocFX site and API layout

Author: rian-be

.github/workflows/publish-docs.yml

@@ -35,9 +35,6 @@ jobs:
       - name: Build docs
         run: docfx docfx.json
 
-      - name: Copy root index
-        run: cp index.html _site/index.html
-
       - name: Mark site as non-Jekyll
         run: touch _site/.nojekyll
 

Docs/API/API.md

@@ -1,18 +1,19 @@
 # API Reference
 
-DocFX generates the public API reference from the compiled assemblies and XML documentation files.
+DocFX generates the public API reference from the project code, compiled assemblies, and XML
+documentation files.
 
 ## Included packages
 
 - `ModularityKit.Mutator`
 - `ModularityKit.Mutator.Governance`
 - `ModularityKit.Mutator.Governance.Redis`
 
-## Build locally
+## Browse the generated API
 
-```bash
-dotnet tool update -g docfx
-docfx docfx.json
-```
+Use the package roots below to explore the public types for each package. These pages are generated
+from the code, not hand-written docs:
 
-The rendered API pages appear under the `API` section of the generated site.
+- [Core package root](../../obj/api/core/ModularityKit.Mutator.Abstractions.html)
+- [Governance package root](../../obj/api/governance/ModularityKit.Mutator.Governance.Abstractions.html)
+- [Redis provider root](../../obj/api/redis/ModularityKit.Mutator.Governance.Redis.html)

Docs/API/Redis.md

@@ -1,31 +1,31 @@
+# ModularityKit.Mutator
+
+ModularityKit.Mutator is a .NET mutation runtime with governance, request lifecycle control,
+approval flow, and Redis-backed storage.
+
 ![ModularityKit.Mutator](../assets/brand/mutator-landing-banner.png)
 
-# ModularityKit.Mutator
+## Start here
 
-ModularityKit.Mutator is a .NET mutation runtime with governance, request lifecycle, approval flow,
-and Redis-backed storage.
+- [API reference](API/Reference.md)
+- [Architecture](Architecture.md)
+- [Core concepts](Core-Concepts.md)
+- [Execution model](ExecutionModel.md)
+- [ADR index](Decision/listadr.md)
 
 ## Packages
 
 | Package | What it covers |
 | --- | --- |
-| [`ModularityKit.Mutator`](../src/README.md) | mutation runtime, policies, execution, audit, history |
-| [`ModularityKit.Mutator.Governance`](../src/Governance/README.md) | request lifecycle, approvals, resolution, governed execution |
+| [`ModularityKit.Mutator`](../src/README.md) | mutation runtime, policies, execution, audit, and history |
+| [`ModularityKit.Mutator.Governance`](../src/Governance/README.md) | request lifecycle, approvals, resolution, and governed execution |
 | [`ModularityKit.Mutator.Governance.Redis`](../src/Redis/README.md) | Redis-backed storage and query provider |
 
-## Explore
-
-| Area | What to read |
-| --- | --- |
-| API reference | [`Docs/API/Reference.md`](API/Reference.md) |
-| Core concepts | [`Docs/Core-Concepts.md`](Core-Concepts.md) |
-| Execution model | [`Docs/ExecutionModel.md`](ExecutionModel.md) |
-| Roadmap | [`Docs/Roadmap.md`](Roadmap.md) |
-
-## What this site contains
+## What is covered
 
 - package overviews for the runtime and governance extensions
 - conceptual docs for the mutation model and request flow
+- decision records for architecture-level changes
 - generated API reference from XML docs
 
 ## Build locally
@@ -34,5 +34,4 @@ and Redis-backed storage.
 dotnet tool update -g docfx
 dotnet build ModularityKit.Mutator.slnx -c Release
 docfx docfx.json
-cp index.html _site/index.html
 ```

Docs/API/Reference.md

@@ -45,7 +45,6 @@ Build the DocFX site locally with:
 dotnet tool update -g docfx
 dotnet build ModularityKit.Mutator.slnx -c Release
 docfx docfx.json
-cp index.html _site/index.html
 ```
 
 The generated site includes the conceptual docs under `Docs/` and the public API reference for the