name: Lint (Docs)
run-name: Lint (Docs)
on:
  push:
    branches:
      - master
  pull_request:
    paths:
      - 'docs/**'
      - 'examples/**'
  merge_group:
    paths:
      - 'docs/**'
      - 'examples/**'

jobs:
  doc-tests:
    name: Lint (Docs)
    if: ${{ !startsWith(github.head_ref, 'dependabot/') }}
    runs-on: ubuntu-latest

    permissions:
      contents: read

    container:
      image: ghcr.io/gravitational/docs:latest
      volumes:
        - ${{ github.workspace }}:/src/content

    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: Run tests
        run: cd /src && yarn markdown-lint