Merge branch 'main' of https://github.com/github/docs-internal into repo-sync

2025-12-30 12:02:01 -05:00 · 2021-09-01 09:45:18 -07:00
parent 453757fab3 78ee3ff9d4
commit 43564ada53
72 changed files with 268 additions and 151 deletions
--- a/.github/workflows/content-changes-table-comment.yml
+++ b/.github/workflows/content-changes-table-comment.yml
@@ -71,20 +71,25 @@ jobs:
              head: context.payload.pull_request.head.sha
            })

-            let changedFiles = response.data.files
-              .map(e => e.filename)
-              .filter(file => file.startsWith('content/') && !file.includes('index'))
+            const files = response.data.files

-            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
-            }
+            let markdownTable = '| **Source** | **Staging** | **Production** | **What Changed** |\n|:----------- |:----------- |:----------- |:----------- |\n'
+
+            files.filter(({ filename }) => filename.startsWith('content/') && !filename.endsWith('/index.md'))
+                 .forEach(file => {
+                   const fileName = file.filename.split('content/')[1]
+                   const sourceUrl = file.blob_url
+                   const fileUrl = fileName.substring(0, fileName.split('.')[0])
+                   const stagingLink = `https://${stagingPrefix}.herokuapp.com/${fileUrl}`
+                   let markdownLine = ''
+                   
+                   if (file.status == 'modified') {
+                     markdownLine = '| [content/' + fileName + '](' + sourceUrl + ') | [Modified](' + stagingLink + ') | [Original](https://docs.github.com/' + fileUrl + ') | | |\n' 
+                   } else if (file.status == 'added') {
+                     markdownLine = '| New file: [content/' + fileName + '](' + sourceUrl + ') | [Modified](' + stagingLink + ') | | | |\n' 
+                   }
+                   markdownTable += markdownLine
+                 })

            function getStagingPrefix (prefix, prNumber, branch) {
              // Added a - in front of prNumber
@@ -102,7 +107,7 @@ jobs:
        with:
          issue-number: ${{ github.event.pull_request.number }}
          comment-author: 'github-actions[bot]'
-          body-includes: '## ⚠️ Automatically generated comment ⚠️'
+          body-includes: '<!-- MODIFIED_CONTENT_LINKING_COMMENT -->'

      - name: Update comment
        uses: peter-evans/create-or-update-comment@5221bf4aa615e5c6e95bb142f9673a9c791be2cd
@@ -110,8 +115,9 @@ jobs:
          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.**
+            <!-- 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.

--- a/.github/workflows/sync-search-indices.yml
+++ b/.github/workflows/sync-search-indices.yml
@@ -22,7 +22,7 @@ name: Sync search indexes
 on:
  workflow_dispatch:
  schedule:
-    - cron: '53 0/4 * * *' # Run every four hours at 53 minutes past the hour
+    - cron: '53 0/8 * * *' # Run every eight hours at 53 minutes past the hour

 jobs:
  updateIndexes:
--- a/assets/images/help/settings/ssh-key-paste.png
+++ b/assets/images/help/settings/ssh-key-paste.png
--- a/components/ui/MarkdownContent/MarkdownContent.tsx
+++ b/components/ui/MarkdownContent/MarkdownContent.tsx
@@ -3,17 +3,18 @@ import cx from 'classnames'

 import styles from './MarkdownContent.module.scss'

-type Props = {
+export type MarkdownContentPropsT = {
  children: string | ReactNode
  className?: string
  as?: keyof JSX.IntrinsicElements
 }
+
 export const MarkdownContent = ({
  children,
  as: Component = 'div',
  className,
  ...restProps
-}: Props) => {
+}: MarkdownContentPropsT) => {
  return (
    <Component
      {...restProps}
--- a/content/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting.md
+++ b/content/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting.md
@@ -16,13 +16,17 @@ miniTocMaxHeadingLevel: 3

 ## Monitoring your workflows

+{% ifversion fpt or ghae or ghes > 3.0 %}
+
 ### Using the visualization graph

 Every workflow run generates a real-time graph that illustrates the run progress. You can use this graph to monitor and debug workflows. For example:

   ![Workflow graph](/assets/images/help/images/workflow-graph.png)

-For more information, see "[Using the visualization graph](/actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph)."
+For more information, see "[Using the visualization graph](/actions/monitoring-and-troubleshooting-workflows/using-the-visualization-graph)." 
+
+{% endif %}

 ### Adding a workflow status badge

--- a/content/github/authenticating-to-github/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account.md
+++ b/content/github/authenticating-to-github/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account.md
@@ -18,7 +18,7 @@ Before adding a new SSH key to your {% data variables.product.product_name %} ac

 After adding a new SSH key to your {% data variables.product.product_name %} account, you can reconfigure any local repositories to use SSH. For more information, see "[Switching remote URLs from HTTPS to SSH](/github/getting-started-with-github/managing-remote-repositories/#switching-remote-urls-from-https-to-ssh)."

-{% data reusables.ssh.dsa-support %}
+{% data reusables.ssh.key-type-support %}

 {% mac %}

--- a/content/github/authenticating-to-github/connecting-to-github-with-ssh/checking-for-existing-ssh-keys.md
+++ b/content/github/authenticating-to-github/connecting-to-github-with-ssh/checking-for-existing-ssh-keys.md
@@ -12,7 +12,7 @@ topics:
  - SSH
 shortTitle: Check for existing SSH key
 ---
-{% data reusables.ssh.dsa-support %}
+{% data reusables.ssh.key-type-support %}

 {% data reusables.command_line.open_the_multi_os_terminal %}
 2. Enter `ls -al ~/.ssh` to see if existing SSH keys are present:
--- a/content/github/authenticating-to-github/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints.md
+++ b/content/github/authenticating-to-github/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints.md
@@ -16,4 +16,12 @@ shortTitle: SSH key fingerprints
 These are {% data variables.product.prodname_dotcom %}'s public key fingerprints:

 - `SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8` (RSA)
+
+These keys will be supported beginning September 14, 2021:
+
+- `SHA256:p2QAMXNIC1TJYWeIOttrVc98/R1BUFWu3/LiyKgUfQM` (ECDSA)
+- `SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU` (Ed25519)
+
+This key will be sunset on November 16, 2021:
+
 - `SHA256:br9IjFspm1vxR3iA35FWE+4VTyz1hYVLIE2t1/CeyWQ` (DSA)
--- a/content/rest/guides/traversing-with-pagination.md
+++ b/content/rest/guides/traversing-with-pagination.md
@@ -36,7 +36,7 @@ provides items in sets of 100
 [events](/rest/reference/activity#events) won't let you set a maximum for items to receive.
 Be sure to read the documentation on how to handle paginated results for specific endpoints.

-Information about pagination is provided in [the Link header](http://tools.ietf.org/html/rfc5988)
+Information about pagination is provided in [the Link header](https://datatracker.ietf.org/doc/html/rfc5988)
 of an API call. For example, let's make a curl request to the search API, to find
 out how many times Mozilla projects use the phrase `addClass`:

--- a/data/reusables/ssh/dsa-support.md
+++ b/data/reusables/ssh/dsa-support.md
@@ -1,5 +0,0 @@
-{% note %}
-
-**Note:** DSA keys (SSH-DSS) are no longer supported. Existing keys will continue to function, but you cannot add new DSA keys to your {% data variables.product.product_name %} account.
-
-{% endnote %}
--- a/data/reusables/ssh/key-type-support.md
+++ b/data/reusables/ssh/key-type-support.md
@@ -0,0 +1,9 @@
+{% note %}
+
+**Note:** {% data variables.product.company_short %} is improving security by dropping older, insecure key types.
+
+DSA keys (`ssh-dss`) are no longer supported. Existing keys will continue to function through March 15, 2022. You cannot add new DSA keys to your user account on {% data variables.product.product_name %}.
+
+RSA keys (`ssh-rsa`) with a `valid_after` before November 2, 2021 may continue to use any signature algorithm. RSA keys generated after that date must use a SHA-2 signature algorithm. Some older clients may need to be upgraded in order to use SHA-2 signatures.
+
+{% endnote %}
--- a/lib/search/indexes/github-docs-2.22-cn-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:934c74b83ebb998087e172270efb88227d92420c6c589f087daed6fe5a8beb45
-size 506808
+oid sha256:7217700dfece309348b94cba7ede91db2199e49cc021b9e2455b74716e939a63
+size 507019
--- a/lib/search/indexes/github-docs-2.22-cn.json.br
+++ b/lib/search/indexes/github-docs-2.22-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:5da497f3c3a41550543ed2ec9936d6f521c12689b18391bccd86a59bbb58e519
-size 802597
+oid sha256:fbcf4b312769a629c678971ec20ae538378154e5276bb482a44f12fc7d3b15ac
+size 802980
--- a/lib/search/indexes/github-docs-2.22-de-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4b5e376f21141e8bbedff8a2f90dabdb07a63c93114ae78cb4ab13868e446783
-size 469350
+oid sha256:64212be95fb1aae6d0047a82e2b2c5c883cf3ee436559684d8111f54211de61e
+size 469365
--- a/lib/search/indexes/github-docs-2.22-de.json.br
+++ b/lib/search/indexes/github-docs-2.22-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:567140753b15674a1503be4c742215d520cae0ebb4b08decbb3a284870e16d23
-size 2077219
+oid sha256:085342f9813d7fa0bb6064fc71b61dc7a4ada57edcb9009ad47f28a10c37cc88
+size 2077837
--- a/lib/search/indexes/github-docs-2.22-en-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a2a7f1fe8b1194d4ecfbe7e29fb165bb570c4b1ac5e48dd068a40242fe123a70
-size 431874
+oid sha256:c478323a9bdb99e1cfbd191eed461e1ecc553a1ce01429d4445a724c48113f80
+size 431890
--- a/lib/search/indexes/github-docs-2.22-en.json.br
+++ b/lib/search/indexes/github-docs-2.22-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8fc0a34d9ca0036ec76b49bec7836dd815de222582ef7c5a16d547c5da87f96a
-size 1695189
+oid sha256:224b5bb9882d5bd301253d3e0cdd6f9161a01646e549d6252c204fa17d88a871
+size 1696127
--- a/lib/search/indexes/github-docs-2.22-es-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:482fdfadb6dd9b5bd9eaf857f9af0775af5ab76431bb5a1bea4ed7c5897c4318
-size 280108
+oid sha256:736c844a16a394b0e7a7cc23c0b6339252dc68ed9ef81becb40d288dbefbe3c3
+size 280141
--- a/lib/search/indexes/github-docs-2.22-es.json.br
+++ b/lib/search/indexes/github-docs-2.22-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:35600ca9c1abec70331b8a65d4f91fed9d9ed43bd2bee80e9231cee42075eda1
-size 1068249
+oid sha256:85fac63f408f4bb20597724f7beea3ea8572be4d4b68136201376fcab5e77999
+size 1068533
--- a/lib/search/indexes/github-docs-2.22-ja-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:9dfa4364937ad067932f0cdd6b39b856bf55f6c998ef66a30489e139b5bc22e6
-size 529223
+oid sha256:5c003673c176dead446142111dea09ca0cdcbe6bdbd28a8bde2628434e8c92d6
+size 529066
--- a/lib/search/indexes/github-docs-2.22-ja.json.br
+++ b/lib/search/indexes/github-docs-2.22-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:7059e7a26af5d8b1e42af70c6770bd0f91726cc138f543e25bd676b1bed1e436
-size 2800355
+oid sha256:331188f45c313487cd329b80491e849251766dc16ad6f255ada36f9ac30535a7
+size 2797094
--- a/lib/search/indexes/github-docs-2.22-pt-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8cb01b090736bc1a101d597999e88e1fc3bc9ce9bbbf1bfdbc81f32de228ceb7
-size 443479
+oid sha256:336e6a58218190b6794745a1ed323166b45d52d2c66e9ec088356e3075478466
+size 443350
--- a/lib/search/indexes/github-docs-2.22-pt.json.br
+++ b/lib/search/indexes/github-docs-2.22-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e98c93afb42ee09242b82fccfd448db0acef4178cdb276b5ea20f53de2c592a8
-size 1851533
+oid sha256:3b723cb8b7d06f8d4868692d1d7145f4cf9b7dd696d46cb1d73be4c6f6941af6
+size 1850845
--- a/lib/search/indexes/github-docs-3.0-cn-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:55998407509df88eaa5b40714ec27b58b1c57b6323c23df5eedbb42b87280132
-size 524981
+oid sha256:4215113297b88180fc7f887023e8c30428beb81c131695d8f713601464945908
+size 524922
--- a/lib/search/indexes/github-docs-3.0-cn.json.br
+++ b/lib/search/indexes/github-docs-3.0-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2cc269f2533b2f58d1da6510b7c831229bb0e26761adf65077da30eb5f088e51
-size 834133
+oid sha256:08456ff02a0301e0673baa30a5017edc231bc60d87666450f7991bc27530e1ed
+size 835027
--- a/lib/search/indexes/github-docs-3.0-de-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3954b9aaa033a2bc1ef548d627969c2490549144331a625d543b0db5de368f7b
-size 490358
+oid sha256:e9c83ec19e5b5911778f377264b82dda4a832e428437c88a49cbbdc53d2101b7
+size 490500
--- a/lib/search/indexes/github-docs-3.0-de.json.br
+++ b/lib/search/indexes/github-docs-3.0-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:9e658e226638d5d22c66968f26fd6c516ba6058aaa96bba5a6e361fbaf82c8e0
-size 2179396
+oid sha256:1af8da3cfaa5a842f182dcf84490d3f0d3cf12ee399b4e5a7e7c5083b1c7e82d
+size 2179367
--- a/lib/search/indexes/github-docs-3.0-en-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0870dc6e665ff1d41e9e729c8bfb68e680115ac097bcf9da63ada411e19d3f0b
-size 452424
+oid sha256:011ae7d968630ff7bd051927cbe5247445a51976085feec40edb7638b5472d9d
+size 452267
--- a/lib/search/indexes/github-docs-3.0-en.json.br
+++ b/lib/search/indexes/github-docs-3.0-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:71b56dfeae81d0b84d765c4c2ec91782938cb21a55d9f13db03d4df72bf56690
-size 1770154
+oid sha256:b600acf6e70839c546b9799d1f0eb3d9e81ca7f0033b2e4aae46bf401bb9f8c9
+size 1769928
--- a/lib/search/indexes/github-docs-3.0-es-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f336e32b19a45127e2f81de3672df8ef3fa3e9bd7fadeccc0c1b7ea3ff04af7e
-size 278470
+oid sha256:2414ee9033782747b8285cb26b5557eaa91cc31d1c74b9733e9e139e97cda13d
+size 278003
--- a/lib/search/indexes/github-docs-3.0-es.json.br
+++ b/lib/search/indexes/github-docs-3.0-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:497d4ef9260085398e9348fb3c508b50c848cd05f9f2835bf0968f34e3478ba6
-size 1056105
+oid sha256:21881c5c5a0da0fa81a1f1bd30e6f086f20f278f1b45874e79ba02bb21d86898
+size 1055629
--- a/lib/search/indexes/github-docs-3.0-ja-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f744d710b7695442f44c9b321d517540e673bd669b50903bb2793bb8444eda3f
-size 550673
+oid sha256:64485dd00a2f9c67cfd61bf9ef619f9c6e94b419f31ed0d8ff6b6054f594aa88
+size 550460
--- a/lib/search/indexes/github-docs-3.0-ja.json.br
+++ b/lib/search/indexes/github-docs-3.0-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:daf4850e384dda2f57df67fe999830a453272c7e93c12376a6d0c65fb9986a85
-size 2914376
+oid sha256:84fdfca1f6bebe0361d86571a5ba65fa4896899a622c872c39285176175573fb
+size 2914766
--- a/lib/search/indexes/github-docs-3.0-pt-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:9372acbfba8622b136cdca542f9c72c7c2faf33238279ad240ba00deafc62f8a
-size 464618
+oid sha256:2fd01b297864c100f19f6c7dc4cfd5627771fc62620c75513df81d5e1a1a9f0f
+size 464406
--- a/lib/search/indexes/github-docs-3.0-pt.json.br
+++ b/lib/search/indexes/github-docs-3.0-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e38440a561afc908d0e5c6f0f25e9398bdf81d2bc235596f9ba758b860191e23
-size 1936753
+oid sha256:479e2aa08cd75791f8b61f7389dfccd421c0d7b4bd12bb89da0d95cb9c53f8da
+size 1936633
--- a/lib/search/indexes/github-docs-3.1-cn-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:44fd9f03007dda2841cb674130a784f47c4857a3fa65896ffc48cb8665b1ca79
-size 534323
+oid sha256:5edf6c72d5357055492778c3c9310d8540f37285d37f8d3a7856cf6e331e69fa
+size 534440
--- a/lib/search/indexes/github-docs-3.1-cn.json.br
+++ b/lib/search/indexes/github-docs-3.1-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:683c9023a4e8ed6bea73f14e9449b18ba7716436d9095825c6ee57c038f585a9
-size 845845
+oid sha256:9a4e1ca8c78a301c70d5f2493a319708b49cecd2c1d5250fb805ca969d443dba
+size 846413
--- a/lib/search/indexes/github-docs-3.1-de-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:9366580721918426dd71fada7c2384672db445683bbcbb09f060be5914c9b99f
-size 497679
+oid sha256:269132ef929fb1cce4b086a6643b67237b0cbcf0d1470e4f1e2c2fa1d0e53795
+size 497613
--- a/lib/search/indexes/github-docs-3.1-de.json.br
+++ b/lib/search/indexes/github-docs-3.1-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c8e819454e9e438326439744ffb34022bacbcb3540145a7ad68d9ee9fd479cb2
-size 2223302
+oid sha256:b758a3048ada038b36a988a693eac354dd7e4ff49e09de392f995c95dc97e4a5
+size 2223335
--- a/lib/search/indexes/github-docs-3.1-en-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6151bb54fca7bb1f6b37f81d85ea6cb9778a343322e6ed8a99b7756815d05c0c
-size 460297
+oid sha256:fa6f0788419408c9e0b839ecca686f4b9c660b4ce5ce12e5542dd0b618a39512
+size 460595
--- a/lib/search/indexes/github-docs-3.1-en.json.br
+++ b/lib/search/indexes/github-docs-3.1-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:25c7ab792df02999e0c11db5419c6967054af243e1c7552afdbaae8d71453d75
-size 1803570
+oid sha256:3924b4926f7b1f4e846515f6fe8af736bf26182ef9f1a6737547436137c35834
+size 1803736
--- a/lib/search/indexes/github-docs-3.1-es-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e831df56dbb7d3b83c424f0ec9f4d620924b8d4e968576286a964f203b0dcf1f
-size 278678
+oid sha256:7080508ed9a3093b74de85d1744142f084e3f0d1f6bac6f3b6c76fa75b95ee19
+size 278577
--- a/lib/search/indexes/github-docs-3.1-es.json.br
+++ b/lib/search/indexes/github-docs-3.1-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:826999b402940d1be8bbed0a60d54d5c818725e28f002c2ead2fdc769102b38b
-size 1057151
+oid sha256:3f081ad98fcb0ec9b720ea594fe89a86d6b77bdbeaf2e6f8a48626f5df499d7e
+size 1057164
--- a/lib/search/indexes/github-docs-3.1-ja-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:822e34b7309c538549977329c41a0df92d3d4b112b85f707c356b714dc7f7225
-size 559141
+oid sha256:d254660cff7e3e9c18ce976ca821b0f058cdb7f862a3c8508d703e4abc034cc2
+size 559117
--- a/lib/search/indexes/github-docs-3.1-ja.json.br
+++ b/lib/search/indexes/github-docs-3.1-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ecac6118d7909d517d7e4fdcddb6c4809dc710327362ab18c1b89ec849c33d4d
-size 2966664
+oid sha256:dafd27ae832a3856ce1a9a0dd37d190096e9cc7f1d8b27873de72480f9f8ec82
+size 2964901
--- a/lib/search/indexes/github-docs-3.1-pt-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:92ec12e9eb0e7e31c3cd746eff58481b6a77573dcf27881d2d3ea00903b7ac0b
-size 472635
+oid sha256:8b3fa6d8660058ce8a1a2174a2e7125234f4ecc3140034fc56fb6c4a2d99a34d
+size 472488
--- a/lib/search/indexes/github-docs-3.1-pt.json.br
+++ b/lib/search/indexes/github-docs-3.1-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:770a0bc254b9d45705d53ee2b36bb9b973cba3fc148eab332972b7a721d526b5
-size 1972410
+oid sha256:841a3d18022bd3e494d34d513559598bcd5505eb5222eb500bbd757ce367ed27
+size 1973282
--- a/lib/search/indexes/github-docs-dotcom-cn-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e67126c9310d3468c9b380f1d4df864271db5f4f86c13a5cf90c82c67945fb61
-size 710011
+oid sha256:16fb6bc813daa795188298cd316b91be64f94f29c1859e2daa90606cbac9982d
+size 710089
--- a/lib/search/indexes/github-docs-dotcom-cn.json.br
+++ b/lib/search/indexes/github-docs-dotcom-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:860978fbc53f411e93c89e26f7c6b30e563e1b0e097bf0bf5876066e4043e2da
-size 969290
+oid sha256:2b99f80c8e2811b86e4f0de63ef18cc136a9fd5b26473080a7f728ca4379bb88
+size 969201
--- a/lib/search/indexes/github-docs-dotcom-de-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4c72b4077e78d8ed1772511f8a7b95e417a9198ddc41d400103e763864fdc50f
-size 647997
+oid sha256:5b3d4a83025171abc2e822ff960dab47740923f604a48efd9c3dd4ee77989e05
+size 647860
--- a/lib/search/indexes/github-docs-dotcom-de.json.br
+++ b/lib/search/indexes/github-docs-dotcom-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:fab9331d52a254fed37e1130b985a01b49563642f99e8bbcb215fb0e1e48e742
-size 2901422
+oid sha256:1f3d6985a7c51dee26da932bdfe1b419dcb48e19d1c337435d9808ce85843e00
+size 2901390
--- a/lib/search/indexes/github-docs-dotcom-en-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0981a5430dddf77ab8f215f366a91372254466ae55ff15cc03c796e0586230f5
-size 624519
+oid sha256:77d6ee679f9d16aad200490dc4670f4d4622f1941827e269996b8baacc6267af
+size 624053
--- a/lib/search/indexes/github-docs-dotcom-en.json.br
+++ b/lib/search/indexes/github-docs-dotcom-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:eecb00be421a28acb7a52c97be902c3600cb5d758d04d348e9af4dcc6c3144dc
-size 2378884
+oid sha256:444ec768a065dce7213cc37b64550fbf277899b7e82de1c69a6cce9601456744
+size 2378280
--- a/lib/search/indexes/github-docs-dotcom-es-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:75ddbd2231f0bb8b702920fb88e9c14d375d9e76c44565c9a59b498ca9fd0d8b
-size 306381
+oid sha256:cdc46f89f55ce61512126f16b897a811b7792cec4415a69476051e9f1f13d108
+size 306503
--- a/lib/search/indexes/github-docs-dotcom-es.json.br
+++ b/lib/search/indexes/github-docs-dotcom-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d3f4844ed4dbf4bbf9304bb61f2b0354da402ecf41db8799625a28d42b991e86
-size 1088498
+oid sha256:72e1ebf3b1c864b8db3cb7d60a57bc62bdd1a37a3424e9e099c714b67d484c40
+size 1089241
--- a/lib/search/indexes/github-docs-dotcom-ja-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:91f75e2107d72e896f264d0d0c89d4cb3ef36602de2bb2a73c09a1a1d1ced197
-size 738240
+oid sha256:134653957d968c73a4c9b4636407bbc7a26fd741fb642aed600d7df9a7f24cd1
+size 738596
--- a/lib/search/indexes/github-docs-dotcom-ja.json.br
+++ b/lib/search/indexes/github-docs-dotcom-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d3861bf4ed3aeff109c59902f97817f044a89c65ecf453207b339528ff0083a4
-size 3851473
+oid sha256:79d92b46d022121497dbe8cfb8ce34736a9df64d883ab87f74dc4bdcb1aa2b6f
+size 3851072
--- a/lib/search/indexes/github-docs-dotcom-pt-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c396f5f78f2fed53f70dcd675d9bb1321329d5ede24bd2d01c8040606f282042
-size 621484
+oid sha256:4f9682432b8ddedc4e0d8bbee9f78cf0032b3fca604bbd8afc23377e412a5918
+size 621427
--- a/lib/search/indexes/github-docs-dotcom-pt.json.br
+++ b/lib/search/indexes/github-docs-dotcom-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bc4114f499018af698a61a8aba159f9aca099bce8250cb975fb846c4dec9a54b
-size 2553639
+oid sha256:d9146fc1f02c5ca2a277f51c608cfc360af0b26f9ef6851770d9dd9ff9b8a08f
+size 2552444
--- a/lib/search/indexes/github-docs-ghae-cn-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:b8806075edd36eae912684d8b74f55db476bcb6677144e32dabcb117709eed64
-size 414155
+oid sha256:31416726a5babab20f844b14faa5b69aaf0cc178e888452356628ccade26e1fa
+size 414359
--- a/lib/search/indexes/github-docs-ghae-cn.json.br
+++ b/lib/search/indexes/github-docs-ghae-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c8531612d5b3794d6ac52f7c77cbafb271a993cf6d945c75cac94d238ca3347d
-size 630160
+oid sha256:c10dd5faab8d0f2e4bbb4570ba3fe55403d72f3cf309609dbb0b324ecb452661
+size 630754
--- a/lib/search/indexes/github-docs-ghae-de-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f1844427be8dd08b0a11b6fcd96230d93c554601755689cbf4f0da76cf511c6a
-size 390824
+oid sha256:58d5cad6690cd400e282cea0d48291bba814122620ecb6e905c3932ce2e83b14
+size 391109
--- a/lib/search/indexes/github-docs-ghae-de.json.br
+++ b/lib/search/indexes/github-docs-ghae-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8a37bb78f86449e3abae2b7c6a43d38c31e2728720f01c14297da7c51f87bb64
-size 1697890
+oid sha256:2bf1814110e86e2c079fd846bb0b53676fdebdaa48a6e21a8ba988052454678f
+size 1700109
--- a/lib/search/indexes/github-docs-ghae-en-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e1a6fd25da4ea26a9da3abbfe55986e6bd02fa372bb33e424c8c503bfb4b347d
-size 360789
+oid sha256:5b95eaaf5feb831447855b37e880251c2a24fcf682bcc57187432d384e8ede33
+size 360572
--- a/lib/search/indexes/github-docs-ghae-en.json.br
+++ b/lib/search/indexes/github-docs-ghae-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8d0af63f4ed25fde548b45b7ca652584a753370a8dceb2fa44a480a6d85e3df2
-size 1353491
+oid sha256:e21f022938f99624972af4cd1eb111bbdadc031674765cbf8e4bbdea98532eba
+size 1353029
--- a/lib/search/indexes/github-docs-ghae-es-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c2cbb0d583194fc93246f15e50cd5f764a8b24d4d70ec09944f5ed60705ef9cb
-size 201042
+oid sha256:630a981324cfa950d4c29edc5f4e926e10d594e70eaf171e3d2842987dc0b3a2
+size 200734
--- a/lib/search/indexes/github-docs-ghae-es.json.br
+++ b/lib/search/indexes/github-docs-ghae-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3e9729e1fee808a4136432c942b007d1ec75e04657cd8c99a3044caacecc8389
-size 718418
+oid sha256:be6f9bcaa04cbe60851a870663678c50b7a1dead11209d8d253203d05716eaf2
+size 718234
--- a/lib/search/indexes/github-docs-ghae-ja-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:fc657f3db3ac900ddc63516bc6d19e87844fabba9c284b5cb0aa22f347a69b1f
-size 435238
+oid sha256:087f9027451375fcb99cd7ac337d05ed7d6d9930ddc3118bc7a241abab67b017
+size 435611
--- a/lib/search/indexes/github-docs-ghae-ja.json.br
+++ b/lib/search/indexes/github-docs-ghae-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3dd391f057d85282fba1514a82ea87d69ee8c9627712b2287ca146ce8295e5d3
-size 2215721
+oid sha256:95d703f0db12d9a0d046f5b7fd55f8636735ceb553f4145f822c897d237fe39b
+size 2217236
--- a/lib/search/indexes/github-docs-ghae-pt-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:cb545c61c4710420297a323a6fb4f12991ad770f44786fc1ff252a58cb677ffc
-size 371602
+oid sha256:21f3868471ae6eee53cb0ea4ff4eb8f98059aa1fdca7ae9df04d4716f0da0198
+size 371947
--- a/lib/search/indexes/github-docs-ghae-pt.json.br
+++ b/lib/search/indexes/github-docs-ghae-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8dfe11d6f0394f94bd85468be659c70b1b331f9e1a6e92780db70b635a81cfc2
-size 1496293
+oid sha256:12a00d29e671071462043d95ca64c2501258951771989eb4ceb94536d90174d9
+size 1497329
--- a/pages/storybook.tsx
+++ b/pages/storybook.tsx
@@ -1,6 +1,82 @@
 import React from 'react'
+import ReactDomServer from 'react-dom/server'
 import { BumpLink, BumpLinkPropsT } from 'components/ui/BumpLink/BumpLink'
 import { Callout, CalloutPropsT } from 'components/ui/Callout/Callout'
+import {
+  MarkdownContent,
+  MarkdownContentPropsT,
+} from 'components/ui/MarkdownContent/MarkdownContent'
+
+const markdownExample = (
+  <>
+    <h1>Header Level 1: Steps example</h1>
+    <ol>
+      <li>Start with step 1</li>
+      <li>Continue with step 2</li>
+      <li>Finish with step 3</li>
+    </ol>
+    <h2>Header Level 2: Highlighted code example</h2>
+    <pre>
+      <code className="hljs language-yaml">
+        <span className="hljs-attr">steps:</span>
+        {'\n'}
+        <span className="hljs-bullet">-</span> <span className="hljs-attr">uses:</span>{' '}
+        <span className="hljs-string">actions/checkout@v2</span>
+        {'\n'}
+        <span className="hljs-bullet">-</span> <span className="hljs-attr">uses:</span>{' '}
+        <span className="hljs-string">actions/setup-java@v2</span>
+        {'\n  '}
+        <span className="hljs-attr">with:</span>
+        {'\n    '}
+        <span className="hljs-attr">java-version:</span> <span className="hljs-string">'11'</span>
+        {'\n    '}
+        <span className="hljs-attr">distribution:</span>{' '}
+        <span className="hljs-string">'adopt'</span>
+      </code>
+    </pre>
+    <h3>Header Level 3: Table example</h3>
+    <table>
+      <thead>
+        <tr>
+          <th>Qualifier</th>
+          <th>Example</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>
+            <code>sort:interactions</code> or <code>sort:interactions-desc</code>
+          </td>
+          <td>
+            <a href="https://github.com/search?q=org%3Agithub+sort%3Ainteractions&amp;type=Issues">
+              <strong>org:github sort:interactions</strong>
+            </a>{' '}
+            matches issues in repositories owned by GitHub, sorted by the highest combined number of
+            reactions and comments.
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <code>sort:interactions-asc</code>
+          </td>
+          <td>
+            <a href="https://github.com/search?utf8=%E2%9C%93&amp;q=org%3Agithub+sort%3Ainteractions-asc&amp;type=Issues">
+              <strong>org:github sort:interactions-asc</strong>
+            </a>{' '}
+            matches issues in repositories owned by GitHub, sorted by the lowest combined number of
+            reactions and comments.
+          </td>
+        </tr>
+      </tbody>
+    </table>
+    <h4>Header Level 4: Procedural image example</h4>
+    <img
+      alt="Group assignment"
+      className="procedural-image-wrapper"
+      src="/assets/images/help/classroom/assignment-group-hero.png"
+    />
+  </>
+)

 const stories = [
  {
@@ -31,8 +107,23 @@ const stories = [
      { variant: 'success', children: 'I am a little font', className: 'f6' } as CalloutPropsT,
    ],
  },
+  {
+    name: 'MarkdownContent',
+    component: MarkdownContent,
+    variants: [{ children: markdownExample } as MarkdownContentPropsT],
+  },
 ]

+function displayProps(props: Object) {
+  const xprops = Object.fromEntries(
+    Object.entries(props).map(([key, value]) => [
+      key,
+      key === 'children' ? ReactDomServer.renderToString(value) : value,
+    ])
+  )
+  return JSON.stringify(xprops, null, 2)
+}
+
 export default function Storybook() {
  return (
    <div className="p-4 mx-auto" style={{ maxWidth: 1200 }}>
@@ -51,13 +142,16 @@ export default function Storybook() {
        <div className="col-12 col-lg-9">
          {stories.map(({ name, component, variants }) => (
            <div id={name} key={name} className="mb-4">
-              <h2 className="position-sticky top-0 color-bg-primary border-bottom">{name}</h2>
+              <h2 className="position-sticky top-0 color-bg-primary border-bottom z-2">{name}</h2>
              {variants.map((props) => (
                <div className="my-4" key={JSON.stringify(props)}>
                  {/* @ts-ignore */}
                  {React.createElement(component, props)}
-                  <pre className="mt-2 p-2 color-bg-tertiary border rounded-2">
-                    {JSON.stringify(props, null, 2)}
+                  <pre
+                    className="mt-2 p-2 color-bg-tertiary border rounded-2"
+                    style={{ whiteSpace: 'pre-wrap' }}
+                  >
+                    {displayProps(props)}
                  </pre>
                </div>
              ))}