Expand Section Links documentation and add a section for Custom Anchors #24061
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Content Changes Table Comment | |
| # **What it does**: When a PR is opened in docs-internal or docs, it adds the staging preview and live article links in a Content Directory Changes table in a comment | |
| # **Why we have it**: To help Docs Content team members and contributors automatically have their staging/live article links added to the table | |
| # **Who does it impact**: docs-internal/docs maintainers and contributors | |
| on: | |
| workflow_dispatch: | |
| inputs: | |
| PR_NUMBER: | |
| description: 'PR Number' | |
| type: string | |
| required: true | |
| BASE_SHA: | |
| description: 'Base SHA' | |
| type: string | |
| required: true | |
| default: 'main' | |
| HEAD_SHA: | |
| description: 'Head SHA (latest sha of the PR)' | |
| type: string | |
| required: true | |
| # Required in lieu of `pull_request` so that the content changes tables can be posts to PRs opened from a fork. | |
| pull_request_target: | |
| types: | |
| - opened | |
| - synchronize | |
| paths: | |
| - 'content/**' | |
| - 'data/reusables/**' | |
| permissions: | |
| contents: read | |
| pull-requests: write | |
| # This allows a subsequently queued workflow run to interrupt previous runs | |
| concurrency: | |
| group: '${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}' | |
| cancel-in-progress: true | |
| jobs: | |
| filterContentDir: | |
| if: ${{ github.event.pull_request.user.login != 'docs-bot' && (github.repository == 'github/docs-internal' || github.repository == 'github/docs') }} | |
| runs-on: ubuntu-latest | |
| env: | |
| PR_NUMBER: ${{ github.event.pull_request.number || inputs.PR_NUMBER }} | |
| steps: | |
| - name: check out repo content | |
| uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1 | |
| - name: Get preview app info | |
| env: | |
| APP_NAME_SEED: ${{ secrets.PREVIEW_ENV_NAME_SEED }} | |
| run: src/workflows/get-preview-app-info.sh | |
| - uses: ./.github/actions/node-npm-setup | |
| - name: Get changes table | |
| id: changes | |
| timeout-minutes: 30 | |
| env: | |
| GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
| APP_URL: ${{ env.APP_URL }} | |
| BASE_SHA: ${{ github.event.pull_request.base.sha || inputs.BASE_SHA }} | |
| HEAD_SHA: ${{ github.event.pull_request.head.sha || inputs.HEAD_SHA }} | |
| run: npm run content-changes-table-comment | |
| - name: Find content directory changes comment | |
| uses: peter-evans/find-comment@3eae4d37986fb5a8592848f6a574fdf654e61f9e | |
| id: findComment | |
| with: | |
| issue-number: ${{ github.event.pull_request.number || inputs.PR_NUMBER }} | |
| comment-author: 'github-actions[bot]' | |
| body-includes: '<!-- MODIFIED_CONTENT_LINKING_COMMENT -->' | |
| - name: Update comment | |
| if: ${{ steps.changes.outputs.changesTable != '' }} | |
| uses: peter-evans/create-or-update-comment@71345be0265236311c031f5c7866368bd1eff043 | |
| with: | |
| comment-id: ${{ steps.findComment.outputs.comment-id }} | |
| issue-number: ${{ github.event.pull_request.number || inputs.PR_NUMBER }} | |
| body: | | |
| <!-- MODIFIED_CONTENT_LINKING_COMMENT --> | |
| ## Automatically generated comment ℹ️ | |
| **This comment is automatically generated and will be overwritten every time changes are committed to this branch.** | |
| The table contains an overview of files in the `content` directory that have been changed in this pull request. It's provided to make it easy to review your changes on the staging site. Please note that changes to the `data` directory will not show up in this table. | |
| --- | |
| ### Content directory changes | |
| _You may find it useful to copy this table into the pull request summary. There you can edit it to share links to important articles or changes and to give a high-level overview of how the changes in your pull request support the overall goals of the pull request._ | |
| ${{ steps.changes.outputs.changesTable }} | |
| --- | |
| fpt: Free, Pro, Team | |
| ghec: GitHub Enterprise Cloud | |
| ghes: GitHub Enterprise Server | |
| edit-mode: replace |