chore(docs): add mkdocs.yml and CI to publish to gh-pages via mike from auto-tunnel

Author: Faxbot Agent

.github/workflows/mkdocs-publish.yml

@@ -0,0 +1,45 @@
+name: Publish MkDocs (mike)
+
+on:
+  push:
+    branches: [ auto-tunnel ]
+    paths:
+      - 'mkdocs.yml'
+      - 'mkdocs/**'
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install mkdocs + material + mike
+        run: |
+          python -m pip install --upgrade pip
+          pip install mkdocs mkdocs-material mike
+
+      - name: Build (sanity)
+        run: |
+          mkdocs build --strict
+
+      - name: Configure git author
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Deploy latest to gh-pages
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          mike deploy --push --remote origin --branch gh-pages latest -m "docs: publish latest from auto-tunnel"
+          mike set-default --push --remote origin --branch gh-pages latest
+

mkdocs.yml

@@ -0,0 +1,69 @@
+site_name: Faxbot Docs
+repo_url: https://github.com/DMontgomery40/Faxbot
+edit_uri: edit/auto-tunnel/mkdocs/docs/
+
+docs_dir: mkdocs/docs
+
+theme:
+  name: material
+  language: en
+  features:
+    - navigation.instant
+    - navigation.tabs
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.code.copy
+  palette:
+    - scheme: slate
+      primary: indigo
+      accent: teal
+
+plugins:
+  - search
+  - mike:
+      version_selector: true
+      canonical_version: latest
+
+nav:
+  - Getting started: getting-started/index.md
+  - Setup:
+      - Phaxio: setup/phaxio.md
+      - Sinch (Fax v3): setup/sinch.md
+      - SignalWire: setup/signalwire.md
+      - Webhooks: setup/webhooks.md
+  - Go‑Live:
+      - Overview: go-live/index.md
+      - Phaxio: go-live/phaxio.md
+      - Sinch: go-live/sinch.md
+      - SignalWire: go-live/signalwire.md
+      - Documo (mFax): go-live/documo.md
+      - HumbleFax: go-live/humblefax.md
+      - SIP/Asterisk: go-live/sip-asterisk.md
+      - FreeSWITCH: go-live/freeswitch.md
+      - One‑Pagers:
+          - Phaxio: go-live/phaxio-onepager.md
+          - Sinch: go-live/sinch-onepager.md
+          - SIP/Asterisk: go-live/sip-asterisk-onepager.md
+          - HumbleFax: go-live/humblefax-onepager.md
+          - Documo: go-live/documo-onepager.md
+  - Admin Console:
+      - Setup Wizard: admin-console/setup-wizard.md
+      - Settings: admin-console/settings.md
+      - Diagnostics: admin-console/diagnostics.md
+      - API Keys: admin-console/api-keys.md
+      - Plugin Builder: admin-console/plugin-builder.md
+  - Networking:
+      - Tunnels: networking/tunnels.md
+  - Security:
+      - Overview: security/index.md
+      - OAuth / OIDC: security/oauth-setup.md
+      - Network Hardening: security/network.md
+  - Apps:
+      - Overview: apps/index.md
+      - iOS: apps/ios.md
+      - Desktop (Electron): apps/electron.md
+  - Reference: reference/index.md
+  - Operations: operations/index.md
+  - Troubleshooting: troubleshooting/index.md
+