internal-check-links-in-documentation.yml

name: Check links in documentation

on:
  pull_request:
    branches:
      - main
    # Watch root level Markdown documentation files and agent/instruction changes
    paths:
      - 'README.md'
      - 'COMMANDS.md'
      - 'GETTING_STARTED.md'
      - 'INTEGRATION.md'
      - 'CHANGELOG.md'
      - 'AGENTS.md'
      - '.github/instructions/**'
      - '.github/skills/**'
      - '.github/workflows/internal-check-links-in-documentation.yml' # also run when this file was changed
  schedule:
    - cron: "42 7 * * 1" # Every week at 07:40 AM on Monday 

jobs:
  reports:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout GIT Repository
      uses: actions/checkout@v6

    - name: Setup node.js
      uses: actions/setup-node@v6
      with:
        node-version-file: '.nvmrc'

    - name: Skip on update of AxonFramework by bot (Renovate)
      if: |
        github.event_name == 'pull_request' && 
        startsWith(github.event.pull_request.title, 'Update dependency AxonFramework') && 
        github.event.pull_request.user.type == 'Bot'
      run: |
        echo "Skipping link check on AxonFramework updates since the updated links to the reports will only be active " 
        echo "skip_link_check=true" >> $GITHUB_ENV

    - name: Check links in top level documentation Markdown files
      if: ${{ ! env.skip_link_check}}
      run: npx --yes markdown-link-check@3.14.2 --config markdown-lint-check-config.json --quiet README.md COMMANDS.md GETTING_STARTED.md INTEGRATION.md AGENTS.md ./.github/instructions ./.github/skills