docs: setup mkdocs pages and health badges

Author: Aitomates

.github/workflows/pages.yml

@@ -0,0 +1,36 @@
+name: Deploy Pages
+on:
+  push:
+    branches:
+      - main
+      - master
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: pip install mkdocs-material
+      - run: mkdocs build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -1,5 +1,8 @@
 # CAS Platform
 
+[![CI](https://github.com/Coding-Autopilot-System/cas-platform/actions/workflows/ci.yml/badge.svg)](https://github.com/Coding-Autopilot-System/cas-platform/actions/workflows/ci.yml) [![CodeQL](https://github.com/Coding-Autopilot-System/cas-platform/actions/workflows/codeql.yml/badge.svg)](https://github.com/Coding-Autopilot-System/cas-platform/actions/workflows/codeql.yml)
+
+
 Production-oriented Azure infrastructure foundation for the Coding Autopilot
 System (CAS). It provides environment-isolated Container Apps hosting,
 workspace-based observability, system-assigned managed identity, budgets, and

docs/index.md

@@ -0,0 +1,3 @@
+# cas-platform Documentation
+
+Welcome to the documentation for cas-platform.

mkdocs.yml

@@ -0,0 +1,3 @@
+site_name: cas-platform Documentation
+theme:
+  name: material