ci: Enhance documentation deployment workflow with debugging and manual trigger

- Add manual workflow dispatch trigger
- Include diagnostic logging steps for mkdocs build process
- Modify artifact upload path to match project structure
- Add verbose output for build configuration and directory contents

.github/workflows/deploy-docs.yml

@@ -7,6 +7,8 @@ on:
     paths:
       - 'docs/**'
       - 'mkdocs.yml'
+  # Allow manual trigger
+  workflow_dispatch:
 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
@@ -23,11 +25,13 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout repository
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - name: Setup Python
+        uses: actions/setup-python@v5
         with:
           python-version: '3.x'
           cache: 'pip'
@@ -40,13 +44,25 @@ jobs:
           python -m pip install --upgrade pip
           pip install -r docs/requirements.txt
 
+      - name: List mkdocs configuration
+        run: |
+          echo "Current directory contents:"
+          ls -la
+          echo "MkDocs version:"
+          mkdocs --version
+          echo "MkDocs configuration:"
+          cat mkdocs.yml
+
       - name: Build documentation
-        run: mkdocs build --strict
+        run: |
+          mkdocs build --strict
+          echo "Build output contents:"
+          ls -la site/advanced-homeassistant-mcp
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: ./site
+          path: ./site/advanced-homeassistant-mcp
 
   deploy:
     environment: