docs.yml

name: Documentation Check

on:
  push:
    branches: [ main, master, develop ]
    paths:
      - '*.md'
      - 'docs/**'
      - 'bindings/**/*.md'
      - '.github/workflows/docs.yml'
  pull_request:
    paths:
      - '*.md'
      - 'docs/**'
      - 'bindings/**/*.md'
      - '.github/workflows/docs.yml'
  workflow_dispatch:

jobs:
  docs-check:
    name: Documentation Check
    runs-on: ubuntu-latest
    
    steps:
    - name: Checkout code
      uses: actions/checkout@v6
    
    - name: Validate documentation
      run: |
        echo "Checking documentation files..."
        test -f README.md
        test -d docs
        test -n "$(find docs -name '*.md' 2>/dev/null)"
        echo "All documentation files present"
    
    - name: Check for broken links
      uses: gaurav-nelson/github-action-markdown-link-check@v1
      with:
        use-quiet-mode: 'yes'
        config-file: '.github/markdown-link-check.json'
      continue-on-error: true