docs: setup mkdocs documentation with configuration and build scripts

Adds mkdocs configuration and documentation infrastructure:
- mkdocs.yml: MkDocs site configuration
- docs/: Documentation markdown files and index
- .github/workflows/deploy-docs.yml: GitHub Actions workflow for automated deployment
- build-docs.sh: Documentation build script
- serve-docs.sh: Local documentation server script
- logo.png: Documentation site logo

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: YosefAshenafi

.github/workflows/deploy-docs.yml

@@ -0,0 +1,39 @@
+name: Build and Deploy Documentation
+
+on:
+  push:
+    branches:
+      - master
+      - main
+    paths:
+      - 'README.md'
+      - '*/README.md'
+      - 'mkdocs.yml'
+      - 'docs/**'
+      - '.github/workflows/deploy-docs.yml'
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install mkdocs mkdocs-material
+
+      - name: Build documentation
+        run: |
+          bash build-docs.sh
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

build-docs.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# Build script for mkdocs documentation
+# This script copies README files into docs/ and builds the site
+
+set -e
+
+echo "Setting up documentation files..."
+
+# Create docs directory
+mkdir -p docs
+
+# Copy README files with appropriate names
+cp README.md docs/index.md
+cp admin/README.md docs/admin.md
+cp admintools/README.md docs/admintools.md
+cp api/README.md docs/api.md
+cp cache/README.md docs/cache.md
+cp constants/README.md docs/constants.md
+cp decorators/README.md docs/decorators.md
+cp extensions/README.md docs/extensions.md
+cp forms/README.md docs/forms.md
+cp middleware/README.md docs/middleware.md
+cp models/README.md docs/models.md
+cp utils/README.md docs/utils.md
+cp validators/README.md docs/validators.md
+cp apps/README.md docs/apps.md
+cp lib/README.md docs/lib.md
+cp test_scaffold/README.md docs/test_scaffold.md
+cp scripts/README.md docs/scripts.md
+cp templatetags/README.md docs/templatetags.md
+
+echo "✓ Documentation files copied"
+
+# Build the site
+echo "Building documentation site..."
+mkdocs build
+
+echo "✓ Documentation built successfully"
+echo "✓ Site output is in the 'site/' directory"

docs/admin.md

@@ -0,0 +1 @@
+../admin/README.md

docs/admintools.md

@@ -0,0 +1 @@
+../admintools/README.md

docs/api.md

@@ -0,0 +1 @@
+../api/README.md

docs/apps.md

@@ -0,0 +1 @@
+../apps/README.md

docs/cache.md

@@ -0,0 +1 @@
+../cache/README.md

docs/constants.md

@@ -0,0 +1 @@
+../constants/README.md

docs/decorators.md

@@ -0,0 +1 @@
+../decorators/README.md

docs/extensions.md

@@ -0,0 +1 @@
+../extensions/README.md