2. Adım: GitHub Actions + SARIF ile PR satırında uyarı verin

Kontrolü `pull_request` iş akışına bağlayıp `--format sarif` çıktısını `github/codeql-action/upload-sarif` adımına verdiğinizde kırık linkler doğrudan PR diff'inde ilgili satır parmak iziyle görünür.

Günlük geliştirme akışında dış URL kontrolünü haftalık zamanlanmış bir job'a ayırıp her PR'da sadece çevrimdışı kontrol çalıştırmak, sıfır ağ kırılganlığıyla birkaç saniyede sonuç almanızı sağlar.

yaml
name: Markdown Link Check
on:
  pull_request:
    paths:
      - "**/*.md"
      - "docs/**"
jobs:
  links:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install deadlinkfinder && deadlinkfinder check .
      - name: Generate SARIF report
        if: always()
        run: deadlinkfinder check . --format sarif > links.sarif
        continue-on-error: true

Kaynak: DeadLinkFinder proje sayfası ve mimari notları

Kaynak: PyPI: deadlinkfinder paketi

Kaynak: GitHub: umutgungorr/deadlinkfinder

Kaynak: Güven Kazanan CLI Araçları Tasarımı