updating docs

.github/workflows/docs.yml

@@ -28,7 +28,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.11'
           cache: 'pip'
@@ -40,7 +40,7 @@ jobs:
 
       - name: Setup Pages
         id: pages
-        uses: actions/configure-pages@v3
+        uses: actions/configure-pages@v4
         if: github.ref == 'refs/heads/main'
 
       - name: Build documentation
@@ -51,7 +51,7 @@ jobs:
           mkdocs build --clean --strict
 
       - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v2
+        uses: actions/upload-pages-artifact@v3
         if: github.ref == 'refs/heads/main'
         with:
           path: ./site
@@ -66,4 +66,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v2
+        uses: actions/deploy-pages@v4

docs/architecture.md

@@ -36,9 +36,9 @@ graph TB
         end
 
         subgraph "OAuth 2.1 Server"
-            AR[/api/oauth/register]
-            AT[/api/oauth/token]
-            AZ[/oauth/authorize]
+            AR["Client Registration<br/>/api/oauth/register"]
+            AT["Token Endpoint<br/>/api/oauth/token"]
+            AZ["Authorization<br/>/oauth/authorize"]
         end
 
         subgraph "MCP Server"

mkdocs.yml

@@ -76,9 +76,9 @@ plugins:
   - minify:
       minify_html: true
 
-# Hooks
-hooks:
-  - docs/hooks.py
+# Hooks (commented out for now)
+# hooks:
+#   - docs/hooks.py
 
 # Extensions
 markdown_extensions:
@@ -96,9 +96,7 @@ markdown_extensions:
       smart_enable: all
   - pymdownx.caret
   - pymdownx.details
-  - pymdownx.emoji:
-      emoji_generator: !!python/name:material.extensions.emoji.to_svg
-      emoji_index: !!python/name:material.extensions.emoji.twemoji
+  - pymdownx.emoji
   - pymdownx.highlight:
       anchor_linenums: true
       line_spans: __span
@@ -112,9 +110,7 @@ markdown_extensions:
       repo: mcp-oauth-sample
   - pymdownx.mark
   - pymdownx.smartsymbols
-  - pymdownx.snippets:
-      auto_append:
-        - includes/mkdocs.md
+  - pymdownx.snippets
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid
@@ -123,9 +119,6 @@ markdown_extensions:
   - pymdownx.tabbed:
       alternate_style: true
       combine_header_slug: true
-      slugify: !!python/object/apply:pymdownx.slugs.slugify
-        kwds:
-          case: lower
   - pymdownx.tasklist:
       custom_checkbox: true
   - pymdownx.tilde
@@ -135,7 +128,6 @@ nav:
   - Home: index.md
   - Getting Started:
     - Setup Guide: setup.md
-    - Quick Start: index.md#quick-start
   - Architecture:
     - System Design: architecture.md
     - Security Model: security.md

requirements.txt

@@ -2,15 +2,8 @@
 mkdocs>=1.5.3
 mkdocs-material>=9.4.0
 
-# Plugins
+# Essential plugins
 mkdocs-minify-plugin>=0.7.1
-mkdocs-redirects>=1.2.1
 
 # Extensions
-pymdown-extensions>=10.3.1
-markdown-callouts>=0.3.0
-
-# Optional enhancements
-mkdocs-git-revision-date-localized-plugin>=1.2.0
-mkdocs-git-committers-plugin-2>=1.2.0
-mkdocs-awesome-pages-plugin>=2.9.2
+pymdown-extensions>=10.3.1

site/_config.yml

@@ -0,0 +1,31 @@
+title: MCP OAuth Sample Documentation
+description: OAuth 2.1 server implementation with MCP integration
+theme: minima
+
+# Navigation
+navbar:
+  - title: Setup
+    url: /setup
+  - title: Architecture
+    url: /architecture
+  - title: Security
+    url: /security
+  - title: Analytics
+    url: /analytics
+  - title: API Reference
+    url: /api
+  - title: Deployment
+    url: /deployment
+  - title: Development
+    url: /development
+  - title: Troubleshooting
+    url: /troubleshooting
+
+# Enable plugins
+plugins:
+  - jekyll-feed
+  - jekyll-sitemap
+
+# Markdown settings
+markdown: kramdown
+highlighter: rouge