Refactor: Consolidate documentation workflows

This commit:
- Removes the separate docs.yml workflow
- Integrates Markdown and code example validation into the existing documentation job
- Adds Markdown linting, link checking, and Lua code validation to docs workflow
- Simplifies CI workflow management

🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>

Author: greggh

.github/workflows/ci.yml

@@ -139,7 +139,7 @@ jobs:
           which ldoc || echo "ldoc not found in PATH"
           ldoc --version || echo "ldoc command failed"
           
-      - name: Generate documentation
+      - name: Generate API documentation
         run: |
           mkdir -p doc/luadoc
           if [ -f .ldoc.cfg ]; then
@@ -150,4 +150,51 @@ jobs:
           fi
           
       - name: List generated documentation
-        run: ls -la doc/luadoc || echo "No documentation generated"
+        run: ls -la doc/luadoc || echo "No documentation generated"
+        
+      - name: Install markdownlint-cli
+        run: npm install -g markdownlint-cli@0.37.0
+      
+      - name: Run markdownlint
+        run: markdownlint '**/*.md' --config .markdownlint.json || true
+        
+      - name: Link Checker
+        uses: lycheeverse/lychee-action@v1.8.0
+        with:
+          args: --verbose --no-progress '**/*.md'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          
+      - name: Check Lua code blocks in markdown
+        run: |
+          find . -type f -name "*.md" -exec grep -l '```lua' {} \; | while read -r file; do
+            echo "Checking Lua snippets in $file"
+            
+            # Create a temporary directory for the snippets
+            TEMP_DIR=$(mktemp -d)
+            
+            # Extract Lua code blocks
+            grep -n '^```lua$' "$file" | while read -r line_start; do
+              # Get the line number where the lua block starts
+              line_num=$(echo "$line_start" | cut -d: -f1)
+              
+              # Find the line number where the next ``` appears
+              line_end=$(tail -n +$((line_num+1)) "$file" | grep -n '^```$' | head -1 | cut -d: -f1)
+              if [ -n "$line_end" ]; then
+                line_end=$((line_num + line_end))
+                
+                # Extract the lua snippet
+                snippet_file="${TEMP_DIR}/snippet_${line_num}.lua"
+                sed -n "$((line_num+1)),$((line_end-1))p" "$file" > "$snippet_file"
+                
+                # Check syntax if file is not empty
+                if [ -s "$snippet_file" ]; then
+                  echo "  Checking snippet starting at line $line_num in $file"
+                  luac -p "$snippet_file" || echo "Syntax error in $file at line $line_num"
+                fi
+              fi
+            done
+            
+            # Clean up
+            rm -rf "$TEMP_DIR"
+          done