Creating Action for adding staging and article links to PR for conte… (#19561)

* Creating actions for adding staging and article links to PR for content writers * Ran prettier * update capitalization in yml file * Update .github/workflows/content-changes-table-comment.yml Co-authored-by: Rachael Sewell <rachmari@github.com> * Update .github/workflows/content-changes-table-comment.yml Co-authored-by: Rachael Sewell <rachmari@github.com> * Update .github/actions-scripts/get-content-changes-table.js Co-authored-by: Rachael Sewell <rachmari@github.com> * Updating fc to findComment * Update .github/actions-scripts/get-content-changes-table.js Co-authored-by: Rachael Sewell <rachmari@github.com> * updating constant * updating fetch depth * Updating yml file and removing script * Adding actions commit for github-script * updating table info * Using mel's wording * update allowed actions * Update .github/workflows/content-changes-table-comment.yml Co-authored-by: Felicity Chapman <felicitymay@github.com> * linting * update * Testing content change * removing tests * updating npm install * back to ci Co-authored-by: Rachael Sewell <rachmari@github.com> Co-authored-by: Felicity Chapman <felicitymay@github.com>
2026-01-06 06:02:35 -05:00 · 2021-08-24 09:45:52 -07:00
parent d50dc507d6
commit d8f7b45e38
3 changed files with 97 additions and 1 deletions
--- a/.github/workflows/content-changes-table-comment.yml
+++ b/.github/workflows/content-changes-table-comment.yml
@@ -0,0 +1,95 @@
+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:
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  PR-Preview-Links:
+    name: Add staging/live links to PR
+    runs-on: ubuntu-latest
+    steps:
+      - name: check out repo content
+        uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Get changes table
+        uses: actions/github-script@2b34a689ec86a68d8ab9478298f91d5401337b7d
+        id: changes
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          script: |
+            const slugify = require('github-slugger').slug
+
+            const HEROKU_APPNAME_MAX_LENGTH = 30
+
+            const repoName = context.payload.repository.name
+            const branchName = context.payload.pull_request.head.ref
+            const prNumber = context.payload.number
+            const stagingPrefix = getStagingPrefix(repoName, prNumber, branchName)
+
+            const response = await github.repos.compareCommits({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              base: context.payload.pull_request.base.sha,
+              head: context.payload.pull_request.head.sha
+            })
+
+            let changedFiles = response.data.files
+              .map(e => e.raw_url)
+              .filter(file => file.includes('/content/'))
+
+            let markdownTable = '| **Article in Staging** | **Live Article** | **Source** | **Changes** |\n| ----------- | ----------- | ----------- | ----------- |\n'
+            for (let file of changedFiles) {
+              file = file.split('/content')[1]
+              const fileURL = file.substring(0, file.length-3)
+              const stagingLink = `https://${stagingPrefix}.herokuapp.com${fileURL}`
+              let fileTitle = file.split('/').pop()
+              fileTitle = fileTitle.substring(0, fileTitle.length - 3)
+              const markdownLine = '| [' + fileTitle + '](' + stagingLink + ') | [' + fileTitle + '](https://docs.github.com' + fileURL + ') | | |\n' 
+              markdownTable += markdownLine
+            }
+
+            function getStagingPrefix (prefix, prNumber, branch) {
+              // Added a - in front of prNumber
+              return `${prefix}-${prNumber}--${slugify(branch)}`
+                .toLowerCase()
+                .slice(0, HEROKU_APPNAME_MAX_LENGTH)
+                .replace(/_/g, '-')
+                .replace(/-+$/, '')
+            }
+            core.setOutput('changesTable', markdownTable)
+
+      - name: Find content directory changes comment
+        uses: peter-evans/find-comment@0da1f4fc1f20cd898368bd56089d391df418f52f
+        id: findComment
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: Content Directory Changes
+
+      - name: Update comment
+        uses: peter-evans/create-or-update-comment@5221bf4aa615e5c6e95bb142f9673a9c791be2cd
+        with:
+          comment-id: ${{ steps.findComment.outputs.comment-id }}
+          issue-number: ${{ github.event.pull_request.number }}
+          body: |
+            ## ⚠️ Automatically generated comment ⚠️ 
+            **This comment is automatically generated and will be overwritten the 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 }}
+          edit-mode: replace