push new nav

Author: nembal

docs/stylesheets/custom.css

@@ -32,6 +32,12 @@
   --shadcn-accent: hsl(210 40% 96%);
   --shadcn-accent-foreground: hsl(222.2 84% 4.9%);
   --md-admonition-icon--agent: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><path d="M320 0c17.7 0 32 14.3 32 32l0 64 120 0c39.8 0 72 32.2 72 72l0 272c0 39.8-32.2 72-72 72l-304 0c-39.8 0-72-32.2-72-72l0-272c0-39.8 32.2-72 72-72l120 0 0-64c0-17.7 14.3-32 32-32zM208 384c-8.8 0-16 7.2-16 16s7.2 16 16 16l32 0c8.8 0 16-7.2 16-16s-7.2-16-16-16l-32 0zm96 0c-8.8 0-16 7.2-16 16s7.2 16 16 16l32 0c8.8 0 16-7.2 16-16s-7.2-16-16-16l-32 0zm96 0c-8.8 0-16 7.2-16 16s7.2 16 16 16l32 0c8.8 0 16-7.2 16-16s-7.2-16-16-16l-32 0zM264 256a40 40 0 1 0 -80 0 40 40 0 1 0 80 0zm152 40a40 40 0 1 0 0-80 40 40 0 1 0 0 80zM48 224l16 0 0 192-16 0c-26.5 0-48-21.5-48-48l0-96c0-26.5 21.5-48 48-48zm544 0c26.5 0 48 21.5 48 48l0 96c0 26.5-21.5 48-48 48l-16 0 0-192 16 0z"/></svg>');
+  --md-admonition-icon--dev: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="%236b6b6b" d="M8.17 11.29a1 1 0 0 1 0 1.42l-3.3 3.29a1 1 0 1 1-1.42-1.42l2.59-2.58-2.59-2.58a1 1 0 1 1 1.42-1.42l3.3 3.29zm7.66 0a1 1 0 0 0 0 1.42l3.3 3.29a1 1 0 1 0 1.42-1.42l-2.59-2.58 2.59-2.58a1 1 0 1 0-1.42-1.42l-3.3 3.29z"/></svg>');
+  --md-admonition-icon--user: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="%236b6b6b" d="M12 12c2.7 0 8 1.34 8 4v2a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-2c0-2.66 5.3-4 8-4zm0-2a4 4 0 1 1 0-8 4 4 0 0 1 0 8z"/></svg>');
+  --dev-admonition-border: #666666;
+  --dev-admonition-bg: rgba(80, 80, 80, 0.15);
+  --user-admonition-border: #555555;
+  --user-admonition-bg: rgba(70, 70, 70, 0.15);
 }
 
 /* Dark mode shadcn colors */
@@ -126,6 +132,38 @@
           mask-image: var(--md-admonition-icon--agent);
 }
 
+/* --- Custom Dev Admonition --- */
+.md-typeset .admonition.dev,
+.md-typeset details.dev {
+  border-color: var(--dev-admonition-border);
+}
+.md-typeset .dev > .admonition-title,
+.md-typeset .dev > summary {
+  background-color: var(--dev-admonition-bg);
+}
+.md-typeset .dev > .admonition-title::before,
+.md-typeset .dev > summary::before {
+  background-color: var(--dev-admonition-border);
+  -webkit-mask-image: var(--md-admonition-icon--dev);
+          mask-image: var(--md-admonition-icon--dev);
+}
+
+/* --- Custom User Admonition --- */
+.md-typeset .admonition.user,
+.md-typeset details.user {
+  border-color: var(--user-admonition-border);
+}
+.md-typeset .user > .admonition-title,
+.md-typeset .user > summary {
+  background-color: var(--user-admonition-bg);
+}
+.md-typeset .user > .admonition-title::before,
+.md-typeset .user > summary::before {
+  background-color: var(--user-admonition-border);
+  -webkit-mask-image: var(--md-admonition-icon--user);
+          mask-image: var(--md-admonition-icon--user);
+}
+
 /* --- ShadCN-style Buttons --- */
 .md-button,
 .md-typeset .md-button {

mkdocs-dev.yml

@@ -6,5 +6,5 @@ INHERIT: mkdocs.yml
 nav:
   - 'Home': 'index.md'
   - 'Work Items': 'work-items/index.md'
-  - 'AID Specification': 'http://127.0.0.1:8001/aid/latest/'
+  - 'AID Specification': 'http://127.0.0.1:8001/aid/specification.md'
   - 'Discussions': 'https://github.com/orgs/agentcommunity/discussions' 

mkdocs.yml

@@ -68,16 +68,31 @@ extra_javascript:
   - https://unpkg.com/mermaid@10.6.1/dist/mermaid.min.js
 
 
+# Main Site Navigation
 # Main Site Navigation
 nav:
   - Home: index.md
   - Work Items: work-items/index.md
   - Agent Interface Discovery (AID):
-    - Introduction: 'aid/index.md'
-    - Design Rationale: 'aid/rationale.md'
-    - Specification: 'aid/specification.md'
-    - Versioning: 'aid/versioning.md'
-  - 'Discussions': 'https://github.com/orgs/agentcommunity/discussions'
+      - Introduction: index.md
+      - Quick Start:
+          - Overview: quickstart/index.md
+          - MCP Guide: quickstart/quickstart_mcp.md
+          - A2A Guide: quickstart/quickstart_a2a.md
+          - OpenAPI Guide: quickstart/quickstart_openapi.md
+      - Design Rationale: rationale.md
+      - Specification: specification.md
+      - Versioning: versioning.md
+      - SDKs:
+          - Go SDK: https://github.com/agentcommunity/agent-interface-discovery/tree/main/packages/aid-go
+          - Python SDK: https://github.com/agentcommunity/agent-interface-discovery/tree/main/packages/aid-py
+      - Blog:
+        - Finding the Front Door: blog/finding_door_a2a.md
+        - The Missing Grep: blog/missing_grep_mcp.md
+        - The Missing MX Record: blog/missing_record.md
+        - What Should Happen When You Type a Domain Name?: blog/what_when_domain.md
+  - Discussions: https://github.com/orgs/agentcommunity/discussions
+      
 
 # Markdown Extensions
 markdown_extensions: