fix: update Taskfile and mkdocs configuration for improved setup and mermaid support

Author: dataGriff

Taskfile.yml

@@ -19,6 +19,7 @@ tasks:
       - pip install mkdocs-git-revision-date-localized-plugin
       - pip install pymdown-extensions
       - echo "Setup complete! Changelog is automatically generated via GitHub Actions."
+      - pip install mkdocs-mermaid2-plugin
     silent: true
 
   build:

docs/README.md

@@ -4,7 +4,7 @@ Welcome to the codebase interface initiative!
 
 The codebase interface is a set of principles and practices that allow us to identify and understand all perspectives of interacting with a codebase, including contributors, users, operators, AI agents, and build agents.
 
-By providing specific interfaces for each audience perspective, we can ensure that everyone has a clean and maintainable experience when interacting with a codebase.
+By providing specific interfaces for each audience perspective, we can ensure that we help all users of the codebase by providing a great experience with clean and maintainable interfaces for all!
 
 ## Guide
 
@@ -15,6 +15,57 @@ By providing specific interfaces for each audience perspective, we can ensure th
 - [Examples](./examples.md)
 - [Tooling](./tooling.md)
 
+## Overview
+
+Remember your codebase is a product with multiple users. We should treat it as such by providing great experiences for all audiences that interact with it.
+
+## Overview
+
+Remember your codebase is a product with multiple users. We should treat it as such by providing great experiences for all audiences that interact with it.
+
+```mermaid
+graph TD
+    %% Central Codebase
+    CODEBASE[🏗️ Codebase<br/>Product]
+    
+    %% Interface Files
+    README["📖 README.md<br/><small>User Interface</small>"]
+    CONTRIBUTING["👥 CONTRIBUTING.md<br/><small>Contributor Interface</small>"]
+    RUNBOOK["🔧 RUNBOOK.md<br/><small>Operations Interface</small>"]
+    AGENTS["🤖 AGENTS.md<br/><small>AI Interface</small>"]
+    BUILD["⚙️ Taskfile<br/><small>Build Interface</small>"]
+    
+    %% Audience Groups
+    USERS["👤 Service Users<br/><small>End Users</small>"]
+    CONTRIBUTORS["🧑‍💻 Contributors<br/><small>Developers</small>"]
+    OPERATORS["🛠️ Operators<br/><small>DevOps/SRE</small>"]
+    AI_AGENTS["🤖 AI Agents<br/><small>Copilot/ChatGPT</small>"]
+    BUILD_AGENTS["🚀 Build Agents<br/><small>CI/CD Systems</small>"]
+    
+    %% Connections: Interfaces to Codebase
+    README -.-> CODEBASE
+    CONTRIBUTING -.-> CODEBASE
+    RUNBOOK -.-> CODEBASE
+    AGENTS -.-> CODEBASE
+    BUILD -.-> CODEBASE
+    
+    %% Connections: Audiences to Interfaces
+    USERS ==> README
+    CONTRIBUTORS ==> CONTRIBUTING
+    OPERATORS ==> RUNBOOK
+    AI_AGENTS ==> AGENTS
+    BUILD_AGENTS ==> BUILD
+    
+    %% Styling
+    classDef codebase fill:#4b9ce2,stroke:#333,stroke-width:3px,color:#fff
+    classDef interface fill:#e3f2fd,stroke:#1976d2,stroke-width:2px,color:#1565c0
+    classDef audience fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#4a148c
+    
+    class CODEBASE codebase
+    class README,CONTRIBUTING,RUNBOOK,AGENTS,BUILD interface
+    class USERS,CONTRIBUTORS,OPERATORS,AI_AGENTS,BUILD_AGENTS audience
+```
+
 ## Support
 
 If your codebase uses codebase interface principles please support the initiative by starring the [Codebase Interface GitHub repository](https://github.com/codebase-interface/codebaseinterface){target="_blank"} and placing the below markdown in the README of your repo.

mkdocs.yml

@@ -45,13 +45,18 @@ plugins:
   - search
   - git-revision-date-localized:
       type: date
+  - mermaid2
 
 markdown_extensions:
   - pymdownx.highlight:
       anchor_linenums: true
   - pymdownx.inlinehilite
   - pymdownx.snippets
-  - pymdownx.superfences
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
   - admonition
   - pymdownx.details
   - attr_list