docs: migrate from Sphinx to MkDocs documentation system

- Replace Sphinx with MkDocs using Material theme
- Add comprehensive documentation structure with guides and API reference
- Create user guides for trading suite, orders, positions, indicators
- Include development documentation for contributors
- Add migration guides for version upgrades
- Configure GitHub Actions for automated docs deployment
- Remove legacy Sphinx documentation files
- Add pragma comments for false positive secret detection
- Set up deployment scripts for documentation hosting

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

Co-Authored-By: Claude <[email protected]>

Author: TexasCoding

.github/workflows/docs.yml

@@ -7,13 +7,15 @@ on:
       - 'docs/**'
       - 'src/**'
       - '.github/workflows/docs.yml'
+      - 'mkdocs.yml'
       - 'pyproject.toml'
   pull_request:
     branches: [ main ]
     paths:
       - 'docs/**'
       - 'src/**'
       - '.github/workflows/docs.yml'
+      - 'mkdocs.yml'
       - 'pyproject.toml'
 
 # Add permissions for GitHub Pages deployment
@@ -38,39 +40,24 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -e .[docs]
+        pip install mkdocs mkdocs-material mkdocstrings[python] mkdocs-jupyter pymdown-extensions
+        pip install -e .
 
-    - name: Check documentation coverage
+    - name: Build documentation
       run: |
-        cd docs
-        make coverage
+        mkdocs build --strict --verbose
 
     - name: Check for broken links
       run: |
-        cd docs
-        make linkcheck
+        pip install linkchecker
+        linkchecker site/
       continue-on-error: true  # Don't fail build on broken external links
 
-    - name: Build documentation
-      run: |
-        cd docs
-        make html
-
-    - name: Check build warnings
-      run: |
-        cd docs
-        if [ -s _build/html/.doctrees/warnings.txt ]; then
-          echo "Documentation build has warnings:"
-          cat _build/html/.doctrees/warnings.txt
-          exit 1
-        fi
-      continue-on-error: true
-
     - name: Upload documentation artifacts
       uses: actions/upload-artifact@v4
       with:
         name: documentation
-        path: docs/_build/html/
+        path: site/
 
   deploy-docs:
     runs-on: ubuntu-latest
@@ -92,29 +79,16 @@ jobs:
       uses: actions/download-artifact@v4
       with:
         name: documentation
-        path: docs/_build/html/
+        path: site/
 
     - name: Setup Pages
       uses: actions/configure-pages@v4
 
     - name: Upload to GitHub Pages
       uses: actions/upload-pages-artifact@v3
       with:
-        path: docs/_build/html/
+        path: site/
 
     - name: Deploy to GitHub Pages
       id: deployment
       uses: actions/deploy-pages@v4
-
-  readthedocs-webhook:
-    runs-on: ubuntu-latest
-    needs: build-docs
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-
-    steps:
-    - name: Trigger ReadTheDocs build
-      run: |
-        curl -X POST \
-          -H "Authorization: Token ${{ secrets.READTHEDOCS_TOKEN }}" \
-          https://readthedocs.org/api/v3/projects/project-x-py/builds/
-      continue-on-error: true  # Don't fail if webhook isn't configured

.github/workflows/mkdocs-deploy.yml

@@ -0,0 +1,60 @@
+name: Deploy MkDocs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Fetch all history for git info
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install mkdocs mkdocs-material mkdocstrings[python] mkdocs-jupyter
+          pip install pymdown-extensions mkdocs-autorefs mkdocs-gen-files
+          pip install mkdocs-literate-nav mkdocs-section-index mike
+          pip install -e .
+
+      - name: Build documentation
+        run: mkdocs build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        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