repo sync

.github/workflows/transfer-to-localization-repo.yml

@@ -0,0 +1,72 @@
+name: Copy to REST API issue to docs-content
+
+# **What it does**: Copies an issue in the open source repo to the docs-content repo, comments on and closes the original issue
+# **Why we have it**: REST API updates cannot be made in the open source repo. Instead, we copy the issue to an internal issue (we do not transfer so that the issue does not disappear for the contributor) and close the original issue.
+# **Who does it impact**: Open source and docs-content maintainers
+
+permissions:
+  contents: write
+
+on:
+  issues:
+    types:
+      - labeled
+
+jobs:
+  transfer-issue:
+    name: Transfer issue
+    runs-on: ubuntu-latest
+    if: (github.event.label.name == 'localization ' && github.repository == 'github/docs')
+    steps:
+      - name: Check if this run was triggered by a member of the docs team
+        uses: actions/github-script@2b34a689ec86a68d8ab9478298f91d5401337b7d
+        id: triggered-by-member
+        with:
+          github-token: ${{secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES}}
+          result-encoding: string
+          script: |
+            const triggerer_login = context.payload.sender.login
+            const teamMembers = await github.request(
+              `/orgs/github/teams/docs/members?per_page=100`
+            )
+            const logins = teamMembers.data.map(member => member.login)
+            if (logins.includes(triggerer_login)) {
+              console.log(`This workflow was triggered by ${triggerer_login} (on the docs team).`)
+              return 'true'
+            }
+            console.log(`This workflow was triggered by ${triggerer_login} (not on the docs team), so no action will be taken.`)
+            return 'false'
+
+      - name: Exit if not triggered by a docs team member
+        if: steps.triggered-by-member.outputs.result == 'false'
+        run: |
+          echo Aborting. This workflow must be triggered by a member of the docs team.
+          exit 1
+
+      - name: Create an issue in the localization repo
+        run: |
+          new_issue_url="$(gh issue create --title "$ISSUE_TITLE" --body "$ISSUE_BODY" --repo github/localization)"
+          echo 'NEW_ISSUE='$new_issue_url >> $GITHUB_ENV
+        env:
+          GITHUB_TOKEN: ${{secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES}}
+          ISSUE_TITLE: ${{ github.event.issue.title }}
+          ISSUE_BODY: ${{ github.event.issue.body }}
+
+      - name: Comment on the new issue
+        run: gh issue comment $NEW_ISSUE --body "This issue was originally opened in the open source repo as $OLD_ISSUE"
+        env:
+          GITHUB_TOKEN: ${{secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES}}
+          NEW_ISSUE: ${{ env.NEW_ISSUE }}
+          OLD_ISSUE: ${{ github.event.issue.html_url }}
+
+      - name: Comment on the old issue
+        run: gh issue comment $OLD_ISSUE --body "Thank you for opening this issue! Updates to translated content must be made internally. I have copied your issue to an internal issue, so I will close this issue."
+        env:
+          GITHUB_TOKEN: ${{secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES}}
+          OLD_ISSUE: ${{ github.event.issue.html_url }}
+
+      - name: Close the old issue
+        run: gh issue close $OLD_ISSUE
+        env:
+          GITHUB_TOKEN: ${{secrets.DOCUBOT_READORG_REPO_WORKFLOW_SCOPES}}
+          OLD_ISSUE: ${{ github.event.issue.html_url }}

Dockerfile.openapi_decorator

@@ -13,6 +13,7 @@ COPY --chown=node:node package-lock.json /openapi-check
 ADD --chown=node:node script /openapi-check/script
 ADD --chown=node:node lib /openapi-check/lib
 ADD --chown=node:node content /openapi-check/content
+ADD --chown=node:node data /openapi-check/data
 
 RUN npm ci -D
 

content/actions/learn-github-actions/events-that-trigger-workflows.md

@@ -808,7 +808,15 @@ on:
 
 {% data reusables.webhooks.workflow_run_desc %}
 
-{% data reusables.github-actions.branch-requirement %}
+{% note %}
+
+**Notes:** 
+
+* This event will only trigger a workflow run if the workflow file is on the default branch.
+
+* You can't use `workflow_run` to chain together more than three levels of workflows. For example, if you attempt to trigger five workflows (named `B` to `F`) to run sequentially after an initial workflow `A` has run (that is: `A` → `B` → `C` → `D` → `E` → `F`), workflows `E` and `F` will not be run.
+
+{% endnote %}
 
 | Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` |
 | --------------------- | -------------- | ------------ | -------------|

content/admin/packages/enabling-github-packages-with-minio.md

@@ -19,7 +19,9 @@ shortTitle: Enable Packages with MinIO
 - Make sure to configure the bucket you'll want to use in the future. We do not recommend changing your storage after you start using {% data variables.product.prodname_registry %}.
 
 {% endwarning %}
+
 ## Prerequisites
+
 Before you can enable and configure {% data variables.product.prodname_registry %} on {% data variables.product.product_location_enterprise %}, you need to prepare your MinIO storage bucket. To help you quickly set up a MinIO bucket and navigate MinIO's customization options, see the "[Quickstart for configuring your MinIO storage bucket for {% data variables.product.prodname_registry %}](/admin/packages/quickstart-for-configuring-your-minio-storage-bucket-for-github-packages)."
 
 Ensure your MinIO external storage access key ID and secret have these permissions:

lib/hydro.js

@@ -3,26 +3,10 @@ import fetch from 'node-fetch'
 import statsd from '../lib/statsd.js'
 import FailBot from '../lib/failbot.js'
 
-const SCHEMAS = {
-  page: 'docs.v0.PageEvent',
-  exit: 'docs.v0.ExitEvent',
-  link: 'docs.v0.LinkEvent',
-  search: 'docs.v0.SearchEvent',
-  searchResult: 'docs.v0.SearchResultEvent',
-  navigate: 'docs.v0.NavigateEvent',
-  survey: 'docs.v0.SurveyEvent',
-  experiment: 'docs.v0.ExperimentEvent',
-  redirect: 'docs.v0.RedirectEvent',
-  clipboard: 'docs.v0.ClipboardEvent',
-  print: 'docs.v0.PrintEvent',
-  preference: 'docs.v0.PreferenceEvent',
-}
-
 export default class Hydro {
   constructor({ secret, endpoint } = {}) {
     this.secret = secret || process.env.HYDRO_SECRET
     this.endpoint = endpoint || process.env.HYDRO_ENDPOINT
-    this.schemas = SCHEMAS
   }
 
   /**
@@ -47,20 +31,14 @@ export default class Hydro {
    * @param {any} value
    */
   async publish(schema, value) {
-    return this.publishMany([{ schema, value }])
-  }
-
-  /**
-   * Publish multiple events to Hydro
-   * @param {[{ schema: string, value: any }]} events
-   */
-  async publishMany(events) {
     const body = JSON.stringify({
-      events: events.map(({ schema, value }) => ({
-        schema,
-        value: JSON.stringify(value), // We must double-encode the value property
-        cluster: 'potomac', // We only have ability to publish externally to potomac cluster
-      })),
+      events: [
+        {
+          schema,
+          value: JSON.stringify(value), // We must double-encode the value property
+          cluster: 'potomac', // We only have ability to publish externally to potomac cluster
+        },
+      ],
     })
     const token = this.generatePayloadHmac(body)
 
@@ -81,23 +59,24 @@ export default class Hydro {
     statsd.increment(`hydro.response_code.${res.status}`, 1, statTags)
     statsd.increment('hydro.response_code.all', 1, statTags)
 
-    // Track hydro exceptions in Sentry, but don't track 503s because we can't do anything about service availability
-    if (!res.ok && res.status !== 503) {
+    // Track hydro exceptions in Sentry,
+    // but don't track 5xx because we can't do anything about service availability
+    if (!res.ok && res.status < 500) {
       const err = new Error(`Hydro request failed: ${res.statusText}`)
       err.status = res.status
 
+      const failures = await res.text()
+
       FailBot.report(err, {
         hydroStatus: res.status,
         hydroText: res.statusText,
+        hydroFailures: failures,
       })
 
       // If the Hydro request failed as an "Unprocessable Entity", log it for diagnostics
       if (res.status === 422) {
-        const failures = await res.json()
         console.error(
-          `Hydro schema validation failed:\n - Request: ${body}\n - Failures: ${JSON.stringify(
-            failures
-          )}`
+          `Hydro schema validation failed:\n - Request: ${body}\n - Failures: ${failures}`
         )
       }
 

lib/redirects/static/redirect-exceptions.txt

@@ -260,4 +260,15 @@
 - /billing/managing-billing-for-your-github-account/managing-invoices-for-your-enterprise
 
 /enterprise-cloud@latest/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization
-- /organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization
+- /organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization
+
+# The initializing-github-ae.md article is referenced in these code files:
+# - lib/github/private_instance_bootstrapper/internal_support_contact.rb
+# - lib/github/private_instance_bootstrapper/saml_idp_configuration.rb
+# - lib/github/private_instance_bootstrapper/policies_configuration.rb
+# This redirect ensures that the links don't resolve to the non-GHAE version 
+# of the docs as this article only exists in the GHAE docs.
+
+/github-ae@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae
+- /admin/configuration/configuring-your-enterprise/initializing-github-ae
+- /enterprise-server@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae

lib/schema-event.js

@@ -461,7 +461,7 @@ const preferenceSchema = {
   },
 }
 
-export default {
+export const eventSchema = {
   oneOf: [
     pageSchema,
     exitSchema,
@@ -477,3 +477,18 @@ export default {
     preferenceSchema,
   ],
 }
+
+export const hydroNames = {
+  page: 'docs.v0.PageEvent',
+  exit: 'docs.v0.ExitEvent',
+  link: 'docs.v0.LinkEvent',
+  search: 'docs.v0.SearchEvent',
+  searchResult: 'docs.v0.SearchResultEvent',
+  navigate: 'docs.v0.NavigateEvent',
+  survey: 'docs.v0.SurveyEvent',
+  experiment: 'docs.v0.ExperimentEvent',
+  redirect: 'docs.v0.RedirectEvent',
+  clipboard: 'docs.v0.ClipboardEvent',
+  print: 'docs.v0.PrintEvent',
+  preference: 'docs.v0.PreferenceEvent',
+}