github-docs/.github/workflows/validate-github-github-docs-urls.yml at main · ab/github-docs · GitHub

View runs

History

131 lines (115 loc) · 5.29 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

name: Validate github/github docs URLs

# **What it does**: Checks the URLs in docs-urls.json in github/github

# **Why we have it**: To ensure the values in docs-urls.json are perfect.

# **Who does it impact**: Docs content.

on:

workflow_dispatch:

schedule:

- cron: '20 16 * * 1' # Run every Monday at 16:20 UTC / 8:20 PST

# See https://gh.io/AAsyyao before uncommenting:

# pull_request:

# paths:

# - 'content/**'

# # In case a relevant dependency changes

# - 'package*.json'

# # The scripts

# - 'src/links/scripts/validate-github-github-docs-urls/**'

# # The workflow

# - .github/workflows/validate-github-github-docs-urls.yml

permissions:

contents: read

issues: write

pull-requests: write

concurrency:

group: ${{ github.workflow }}-${{ github.ref }}

cancel-in-progress: true

jobs:

validate_github_github_docs_urls:

name: Validate github/github docs URLs

if: github.repository == 'github/docs-internal'

runs-on: ubuntu-20.04-xl

steps:

- name: Check out repo's default branch

uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

- uses: ./.github/actions/node-npm-setup

- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

with:

token: ${{ secrets.DOCS_BOT_PAT_BASE }}

repository: github/github

ref: master

path: github

- name: Run validation

run: |

# This will generate a .json file which we can use to

# do other things in other steps.

npm run validate-github-github-docs-urls -- validate \

--output checks.json \

--ignore-not-found \

github/config/docs-urls.json

- name: Update config/docs-urls.json in github/github (possibly)

if: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}

env:

GITHUB_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}

run: |

npm run validate-github-github-docs-urls -- generate-new-json checks.json github/config/docs-urls.json

git config --global user.name "docs-bot"

git config --global user.email "77750099+docs-bot@users.noreply.github.com"

cd github

git status

git diff

changes=$(git diff --name-only | wc -l)

if [[ $changes -eq 0 ]]; then

echo "There are no changes to commit after running generate-new-json. Exiting this step"

exit 0

current_timestamp=$(date '+%Y-%m-%d-%H%M%S')

branch_name="update-docs-urls-$current_timestamp"

git checkout -b "$branch_name"

current_daystamp=$(date '+%Y-%m-%d')

git commit -a -m "Update Docs URLs from automation ($current_daystamp)"

git push origin "$branch_name"

# XXX TODO

# Perhaps post an issue somewhere, about that the fact that this

# branch has been created and now needs to be turned into a PR

# that some human can take responsibility for.

- name: Clean up old branches in github/github

if: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}

env:

GITHUB_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}

run: |

npm run validate-github-github-docs-urls -- clean-up-old-branches --prefix update-docs-urls

echo "To see them all, go to:"

echo "https://github.com/github/github/branches/all?query=update-docs-urls-"

# If a PR comes along to github/docs-internal that causes some

# URLs in docs-urls.json (in github/github) to now fail, then

# we'll want to make the PR author+reviewer aware of this.

# For example, you moved a page without setting up a redirect.

# Or you edited a heading that now breaks a URL with fragment.

# In the latter case, you might want to update the URL in docs-urls.json

# after this PR has landed, or consider using `<a name="..."></a>` as a

# workaround for the time being.

# First, gather the URLs that were relevant

- name: Get changed content/data files

if: ${{ github.event_name == 'pull_request' }}

id: changed_files

uses: ./.github/actions/get-changed-files

with:

files: |

content/**

- name: Generate PR comment

if: ${{ github.event_name == 'pull_request' && steps.changed_files.outputs.filtered_changed_files }}

env:

# Make it an environment variable so that its value doesn't need to be escaped.

# See https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions#using-an-intermediate-environment-variable

CHANGED_FILES: |-

${{ steps.changed_files.outputs.filtered_changed_files }}

GITHUB_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}

ISSUE_NUMBER: ${{ github.event.pull_request.number }}

REPOSITORY: ${{ github.repository }}

run: |

npm run validate-github-github-docs-urls -- post-pr-comment checks.json --changed-files $CHANGED_FILES

- uses: ./.github/actions/slack-alert

if: ${{ failure() && github.event_name == 'schedule' }}

with:

slack_channel_id: ${{ secrets.DOCS_ALERTS_SLACK_CHANNEL_ID }}

slack_token: ${{ secrets.SLACK_DOCS_BOT_TOKEN }}

github-docs/.github/workflows/validate-github-github-docs-urls.yml at main · ab/github-docs · GitHub

Expand file tree

Breadcrumbs

validate-github-github-docs-urls.yml

Latest commit

History

Breadcrumbs

validate-github-github-docs-urls.yml

File metadata and controls