Repo sync

content/rest/secret-scanning/alert-dismissal-requests.md

@@ -0,0 +1,13 @@
+---
+title: Alert dismissal requests
+shortTitle: Alert dismissal requests
+intro: Use the REST API to manage alert dismissal requests for secret scanning.
+versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
+  ghec: '*'
+topics:
+  - API
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+<!-- Content after this section is automatically generated -->

content/rest/secret-scanning/index.md

@@ -10,6 +10,7 @@ versions:
 topics:
   - API
 children:
+  - /alert-dismissal-requests
   - /delegated-bypass
   - /secret-scanning
 autogenerated: rest

src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json

@@ -5460,6 +5460,33 @@
         "additional-permissions": false,
         "access": "write"
       },
+      {
+        "category": "secret-scanning",
+        "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning",
+        "additional-permissions": true,
+        "access": "read"
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "additional-permissions": true,
+        "access": "read"
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "patch",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "additional-permissions": true,
+        "access": "read"
+      },
       {
         "category": "repos",
         "slug": "create-a-repository-dispatch-event",
@@ -8007,6 +8034,15 @@
         "additional-permissions": false,
         "access": "read"
       },
+      {
+        "category": "secret-scanning",
+        "slug": "list-alert-dismissal-requests-for-secret-scanning-for-an-org",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/dismissal-requests/secret-scanning",
+        "additional-permissions": false,
+        "access": "read"
+      },
       {
         "category": "secret-scanning",
         "slug": "list-secret-scanning-alerts-for-an-organization",
@@ -8052,6 +8088,33 @@
         "additional-permissions": false,
         "access": "read"
       },
+      {
+        "category": "secret-scanning",
+        "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning",
+        "additional-permissions": true,
+        "access": "read"
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "additional-permissions": true,
+        "access": "read"
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "patch",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "additional-permissions": true,
+        "access": "read"
+      },
       {
         "category": "secret-scanning",
         "slug": "list-secret-scanning-alerts-for-a-repository",

src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json

@@ -5356,6 +5356,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/bypass-requests/secret-scanning"
     },
+    {
+      "slug": "list-alert-dismissal-requests-for-secret-scanning-for-an-org",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/orgs/{org}/dismissal-requests/secret-scanning"
+    },
     {
       "slug": "list-secret-scanning-alerts-for-an-organization",
       "subcategory": "secret-scanning",
@@ -5386,6 +5392,24 @@
       "verb": "delete",
       "requestPath": "/repos/{owner}/{repo}/bypass-responses/secret-scanning/{bypass_response_id}"
     },
+    {
+      "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning"
+    },
+    {
+      "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}"
+    },
+    {
+      "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "patch",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}"
+    },
     {
       "slug": "list-secret-scanning-alerts-for-a-repository",
       "subcategory": "secret-scanning",

src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json

@@ -6622,6 +6622,39 @@
         "server-to-server": true,
         "additional-permissions": false
       },
+      {
+        "category": "secret-scanning",
+        "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": true
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": true
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "patch",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": true
+      },
       {
         "category": "repos",
         "slug": "create-a-repository-dispatch-event",
@@ -9730,6 +9763,17 @@
         "server-to-server": false,
         "additional-permissions": false
       },
+      {
+        "category": "secret-scanning",
+        "slug": "list-alert-dismissal-requests-for-secret-scanning-for-an-org",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/dismissal-requests/secret-scanning",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "secret-scanning",
         "slug": "list-secret-scanning-alerts-for-an-organization",
@@ -9785,6 +9829,39 @@
         "server-to-server": false,
         "additional-permissions": false
       },
+      {
+        "category": "secret-scanning",
+        "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": true
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": true
+      },
+      {
+        "category": "secret-scanning",
+        "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+        "subcategory": "alert-dismissal-requests",
+        "verb": "patch",
+        "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": true
+      },
       {
         "category": "secret-scanning",
         "slug": "list-secret-scanning-alerts-for-a-repository",

src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json

@@ -4870,12 +4870,36 @@
     }
   ],
   "secret-scanning": [
+    {
+      "slug": "list-alert-dismissal-requests-for-secret-scanning-for-an-org",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/orgs/{org}/dismissal-requests/secret-scanning"
+    },
     {
       "slug": "list-secret-scanning-alerts-for-an-organization",
       "subcategory": "secret-scanning",
       "verb": "get",
       "requestPath": "/orgs/{org}/secret-scanning/alerts"
     },
+    {
+      "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning"
+    },
+    {
+      "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}"
+    },
+    {
+      "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "patch",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}"
+    },
     {
       "slug": "list-secret-scanning-alerts-for-a-repository",
       "subcategory": "secret-scanning",

src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json

@@ -5356,6 +5356,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/bypass-requests/secret-scanning"
     },
+    {
+      "slug": "list-alert-dismissal-requests-for-secret-scanning-for-an-org",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/orgs/{org}/dismissal-requests/secret-scanning"
+    },
     {
       "slug": "list-secret-scanning-alerts-for-an-organization",
       "subcategory": "secret-scanning",
@@ -5386,6 +5392,24 @@
       "verb": "delete",
       "requestPath": "/repos/{owner}/{repo}/bypass-responses/secret-scanning/{bypass_response_id}"
     },
+    {
+      "slug": "list-alert-dismissal-requests-for-secret-scanning-for-a-repository",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning"
+    },
+    {
+      "slug": "get-an-alert-dismissal-request-for-secret-scanning",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}"
+    },
+    {
+      "slug": "review-an-alert-dismissal-request-for-secret-scanning",
+      "subcategory": "alert-dismissal-requests",
+      "verb": "patch",
+      "requestPath": "/repos/{owner}/{repo}/dismissal-requests/secret-scanning/{alert_number}"
+    },
     {
       "slug": "list-secret-scanning-alerts-for-a-repository",
       "subcategory": "secret-scanning",

src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "c5cf21bd038d40077bcb9a9dffd0c8d0691c1d78"
+  "sha": "a3b90207333d17877bcbab612a4163337ed7148c"
 }

src/learning-track/lib/get-link-data.js

@@ -3,6 +3,7 @@ import findPage from '#src/frame/lib/find-page.js'
 import nonEnterpriseDefaultVersion from '#src/versions/lib/non-enterprise-default-version.js'
 import removeFPTFromPath from '#src/versions/lib/remove-fpt-from-path.js'
 import { renderContent } from '#src/content-render/index.js'
+import { executeWithFallback } from '#src/languages/lib/render-with-fallback.js'
 
 // rawLinks is an array of paths: [ '/foo' ]
 // we need to convert it to an array of localized objects: [ { href: '/en/foo', title: 'Foo', intro: 'Description here' } ]
@@ -41,7 +42,13 @@ async function processLink(link, context, option) {
   const opts = { textOnly: true }
   const linkHref = link.href || link
   // Parse the link in case it includes Liquid conditionals
-  const linkPath = linkHref.includes('{') ? await renderContent(linkHref, context, opts) : linkHref
+  const linkPath = linkHref.includes('{')
+    ? await executeWithFallback(
+        context,
+        () => renderContent(linkHref, context, opts),
+        () => '', // todo get english linkHref
+      )
+    : linkHref
   // If the link was `{% ifversion ghes %}/admin/foo/bar{% endifversion %}`
   // the `context.currentVersion` was `enterprise-cloud`, the final
   // output would become '' (empty string).

src/learning-track/lib/process-learning-tracks.js

@@ -1,7 +1,7 @@
-import { renderContent } from '#src/content-render/index.js'
 import getLinkData from './get-link-data.js'
 import getApplicableVersions from '#src/versions/lib/get-applicable-versions.js'
 import { getDataByLanguage } from '#src/data-directory/lib/get-data.js'
+import { renderContent } from '#src/content-render/index.js'
 import { executeWithFallback } from '#src/languages/lib/render-with-fallback.js'
 
 const renderOpts = { textOnly: true }
@@ -18,7 +18,11 @@ export default async function processLearningTracks(rawLearningTracks, context)
   for (const rawTrackName of rawLearningTracks) {
     // Track names in frontmatter may include Liquid conditionals.
     const renderedTrackName = rawTrackName.includes('{')
-      ? await renderContent(rawTrackName, context, renderOpts)
+      ? await executeWithFallback(
+          context,
+          () => renderContent(rawTrackName, context, renderOpts),
+          () => '', // todo use english rawTrackName
+        )
       : rawTrackName
     if (!renderedTrackName) continue