馃摎 Add complete documentation system with CI/CD

- Add Sphinx documentation (docs/)
- Add GitHub Actions workflow for docs build
- Add Read the Docs configuration
- Documentation includes: quickstart, configuration, authentication, API reference
- Auto-deploy to GitHub Pages on push

Author: HzaCode

.github/workflows/docs.yml

@@ -0,0 +1,103 @@
+name: Build and Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+      - gh
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+      
+      - name: 📦 Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r docs/requirements.txt
+          pip install -e .
+      
+      - name: 🔨 Build documentation
+        run: |
+          cd docs
+          make html
+      
+      - name: 📊 Check build
+        run: |
+          if [ ! -d "docs/_build/html" ]; then
+            echo "❌ Build failed - no output directory"
+            exit 1
+          fi
+          echo "✅ Documentation built successfully"
+          ls -la docs/_build/html
+      
+      - name: 🚀 Deploy to GitHub Pages
+        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/gh')
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs/_build/html
+          publish_branch: gh-pages
+          force_orphan: true
+          user_name: 'github-actions[bot]'
+          user_email: 'github-actions[bot]@users.noreply.github.com'
+          commit_message: '📚 Deploy documentation from ${{ github.ref }}'
+      
+      - name: 📤 Upload artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: documentation
+          path: docs/_build/html
+          retention-days: 30
+      
+      - name: ✅ Summary
+        run: |
+          echo "### 📚 Documentation Build Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "✅ Build completed successfully" >> $GITHUB_STEP_SUMMARY
+          echo "📦 Branch: \`${{ github.ref_name }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "🔗 Commit: \`${{ github.sha }}\`" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ github.event_name }}" == "push" ]; then
+            echo "🚀 Deployed to GitHub Pages" >> $GITHUB_STEP_SUMMARY
+          fi
+
+  lint-docs:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+      
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+      
+      - name: 📦 Install doc8
+        run: |
+          pip install doc8 sphinx
+      
+      - name: 🔍 Lint documentation
+        run: |
+          cd docs
+          doc8 . --ignore D001 --max-line-length 100 || true
+          echo "✅ Documentation linting completed"
+

.readthedocs.yml

@@ -0,0 +1,33 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: false
+
+# Optionally build your docs in additional formats such as PDF and ePub
+formats:
+  - pdf
+  - epub
+
+# Set the version of Python and requirements required to build your docs
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  jobs:
+    post_create_environment:
+      - pip install poetry
+    post_install:
+      - pip install -r docs/requirements.txt
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+

docs/.gitignore

@@ -0,0 +1,25 @@
+# Sphinx build directories
+_build/
+_static/
+_templates/
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Generated files
+*.log
+*.pot
+
+# Distribution / packaging
+.eggs/
+*.egg-info/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+

docs/Makefile

@@ -0,0 +1,21 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+