chore: update docs

Author: somethim

docs/GOVERNANCE.md

@@ -12,7 +12,7 @@ This package follows SemVer:
 
 - Public package APIs and documented config keys are treated as compatibility surfaces.
 - New behavior defaults should remain backward-compatible in minor/patch releases.
-- Security hardening defaults that can change behavior should be called out in `docs/UPGRADE.md`.
+- Security hardening defaults that can change behavior should be called out in release notes.
 
 ## Deprecation policy
 
@@ -26,5 +26,5 @@ When a key or behavior is superseded:
 ## Release controls
 
 - Run `composer pint -- --test`, `composer analyse`, and `composer test` before release.
-- Update `docs/UPGRADE.md` for behavior/config changes.
+- Update release notes for behavior/config changes.
 - Tag releases with semantic versions.

docs/UPGRADE.md

@@ -11,7 +11,6 @@ A flexible Attribute-Based Access Control (ABAC) implementation for Laravel 12+.
 - [Operations Guide](OPERATIONS.md)
 - [Benchmarking](BENCHMARKING.md)
 - [Security Model](SECURITY_MODEL.md)
-- [Upgrade Guide](UPGRADE.md)
 
 ## Key Features
 

docs/index.md

@@ -14,18 +14,32 @@ theme:
       scheme: default
       primary: blue
       accent: blue
+      toggle:
+        icon: material/weather-night
+        name: Switch to dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
       primary: blue
       accent: blue
+      toggle:
+        icon: material/weather-sunny
+        name: Switch to light mode
 
 markdown_extensions:
   - attr_list
   - md_in_html
   - tables
   - admonition
   - pymdownx.details
-  - pymdownx.superfences
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+
+extra_javascript:
+  - https://unpkg.com/mermaid@10/dist/mermaid.min.js
+  - javascripts/mermaid.js
 
 nav:
   - Home: index.md
@@ -36,5 +50,4 @@ nav:
   - Operations: OPERATIONS.md
   - Benchmarking: BENCHMARKING.md
   - Security Model: SECURITY_MODEL.md
-  - Upgrade Guide: UPGRADE.md
   - Governance: GOVERNANCE.md