check-all-links.yml

name: Check all content (MDX) links

on:
  pull_request:

permissions:
  actions: read
  checks: read
  contents: read
  issues: write
  pull-requests: write

jobs:
  check-for-absolute-urls:
    name: "Check for absolute prisma.io urls"
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: check for docs urls
        id: absolute-urls
        run: |
          FILES_WITH_ABS_URLS=$(grep -Erl "https://prisma\.io/docs|https://www\.prisma\.io/docs" content) || echo "no absolute URLs found."
          OUTPUT="## Absolute URL check"$'\n'
          SUCCESS=false
          if [ -n "${FILES_WITH_ABS_URLS}" ]; then  # if there were matching files
            OUTPUT+="The following files have absolute URLs to prisma.io/docs. Please replace them with relative URLs."$'\n'
            OUTPUT+="Example: https://www.prisma.io/docs/getting-started/quickstart -> /getting-started/quickstart"$'\n'
            for line in ${FILES_WITH_ABS_URLS}
            do
              OUTPUT+="${line}"$'\n'
            done
          else
            # no matching files
            OUTPUT+="No absolute URLs to prisma.io/docs found."
            SUCCESS=true
          fi
          # https://github.com/orgs/community/discussions/26288#discussioncomment-3876281
          {
            echo 'body<<EOF'
            echo "$OUTPUT"
            echo EOF
          } >> "$GITHUB_OUTPUT"
          echo "success=${SUCCESS}" >> "$GITHUB_OUTPUT"

      - uses: ./.github/actions/create-or-update-comment
        with:
          pull-request: ${{ github.event.pull_request.number }}
          body: ${{ steps.absolute-urls.outputs.body }}
          body-includes: absolute URLs
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: report success
        run: |
          if ${{ steps.absolute-urls.outputs.success }}; then
            exit 0;
          else
            exit 1;
          fi

  check-for-dead-external-links:
    name: Check external links
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 18

      - name: Install deps
        run: npm install

      - name: Install remark presets
        run: npm install remark-lint-no-dead-urls remark-custom-header-id

      - name: run remark-cli
        env:
          BRANCH_NAME: ${{ github.head_ref || github.ref_name }}
        run: |
          npx remark-cli . -qf -e=md,mdx --use remark-mdx --use remark-custom-header-id --use remark-frontmatter --use remark-gfm \
          --use "remark-lint-no-dead-urls=skipLocalhost:true,skipUrlPatterns:['https://www.notion.so/prismaio','https://www.prisma.io/docs','https://dash.cloudflare.com','https://www.cloudflare.com']"

  check-for-dead-internal-links:
    name: Check internal links
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 18

      - name: Install deps
        run: npm install

      - name: test build
        run: npm run clean && npm run build

  check-for-redirects:
    name: Check for needed redirects
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Create suggested redirects
        id: redirects
        run: |
          bash .github/workflows/scripts/generate-redirects.sh

      - uses: ./.github/actions/create-or-update-comment
        with:
          pull-request: ${{ github.event.pull_request.number }}
          body: ${{ steps.redirects.outputs.body }}
          body-includes: following redirects
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}