Add MkDocs Material site with GitHub Pages deployment

Adds mkdocs.yml config and GitHub Actions workflow that auto-builds
and deploys docs to GitHub Pages on push to main.

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

Author: promisingcoder

.github/workflows/docs.yml

@@ -0,0 +1,45 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - run: pip install mkdocs-material
+
+      - run: mkdocs build --strict
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

mkdocs.yml

@@ -0,0 +1,56 @@
+site_name: gmaps-extractor
+site_description: Extract business data from Google Maps at scale
+site_url: https://promisingcoder.github.io/GoogleMapsCollector/
+repo_url: https://github.com/promisingcoder/GoogleMapsCollector
+repo_name: promisingcoder/GoogleMapsCollector
+
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: blue grey
+      accent: teal
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: blue grey
+      accent: teal
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.instant
+    - navigation.sections
+    - navigation.top
+    - search.highlight
+    - content.code.copy
+
+markdown_extensions:
+  - tables
+  - admonition
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.superfences
+  - pymdownx.details
+
+nav:
+  - Home: index.md
+  - Getting Started:
+      - Installation: installation.md
+      - Prerequisites & Setup: prerequisites.md
+      - Quick Start: quick-start.md
+  - Usage:
+      - Python Library API: python-api.md
+      - CLI Reference: cli-reference.md
+      - Configuration: configuration.md
+  - Features:
+      - Output Format: output-format.md
+      - Subdivision Mode: subdivision-mode.md
+      - Resuming Collections: resuming-collections.md
+      - Rate Limiting & Performance: rate-limiting.md
+  - Reference:
+      - Error Handling: error-handling.md
+      - Troubleshooting: troubleshooting.md
+      - Examples: examples.md
+      - Known Limitations: known-limitations.md