Skip to content

Commit cbde30f

Browse files
Merge branch 'main' into patch-1
2 parents 2f7b24b + df4329a commit cbde30f

888 files changed

Lines changed: 18887 additions & 6399 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/instructions/content.instructions.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,14 @@ Before committing content changes, always:
1616
3. **Verify [AUTOTITLE] links** point to existing articles
1717
4. **Run tests** on changed content: `npm run test -- src/content-render/tests/render-changed-and-deleted-files.ts`
1818

19+
## Accuracy and flagging uncertainty
20+
21+
AI assistants can produce plausible but incorrect information. To protect readers and writers:
22+
23+
* Never fabricate product behavior, settings, permissions, API parameters, or limits. If you cannot verify a detail from the source material or the product itself, say so instead of guessing.
24+
* Flag uncertainty at the level of the specific claim, not the whole article. Identify the individual sentence, step, value, or setting you are unsure about, rather than labeling an entire article as "needs review."
25+
* After writing or editing, give the writer a checklist of each specific claim to verify, noting where it appears (the exact step or sentence) and why it needs checking. Prioritize claims where being wrong could have serious consequences, such as security, authentication, permissions, billing, or any irreversible action, and recommend confirming those with the relevant product or engineering team.
26+
1927
## Bullet lists
2028

2129
The bulleted points in a bullet list should always be denoted in Markdown using an asterisk, not a hyphen.

.github/workflows/dont-delete-features.yml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,7 @@ permissions:
2525

2626
jobs:
2727
dont-delete-features:
28-
# It's 'docs-bot' that creates those PR from "Delete orphaned features"
29-
if: github.event.pull_request.user.login != 'docs-bot' && (github.repository == 'github/docs-internal' || github.repository == 'github/docs')
28+
if: github.event.pull_request.user.login != 'docs-bot' && github.event.pull_request.user.login != 'docs-engineering-bot[bot]' && (github.repository == 'github/docs-internal' || github.repository == 'github/docs')
3029
runs-on: ubuntu-latest
3130
steps:
3231
- name: Check out repo

.github/workflows/link-check-on-pr.yml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -59,14 +59,12 @@ jobs:
5959
6060
- name: Check links in changed files
6161
if: steps.changed-files.outputs.any_changed == 'true'
62-
# Work in progress: never fail the PR. The comment is informational only.
63-
continue-on-error: true
6462
env:
6563
FILES_CHANGED: ${{ steps.changed-files.outputs.all_changed_files }}
6664
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
6765
ACTION_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
6866
SHOULD_COMMENT: ${{ secrets.DOCS_BOT_APP_ID != '' }}
69-
FAIL_ON_FLAW: false
67+
FAIL_ON_FLAW: true
7068
ENABLED_LANGUAGES: en
7169
run: npm run check-links-pr
7270

.github/workflows/ready-for-doc-review.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ jobs:
2929
owner: github
3030
# Scope must include every repo that calls this reusable workflow, because
3131
# the script resolves the PR node (ITEM_NODE_ID) in the calling repo.
32-
repositories: docs-internal,docs-content,docs-strategy,docs-early-access,github
32+
repositories: docs-internal,docs-content,docs-strategy,docs-early-access,docs-team,github
3333

3434
- name: Check out repo content
3535
uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0

.github/workflows/sync-openapi.yml

Lines changed: 4 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -42,30 +42,21 @@ jobs:
4242
path: rest-api-description
4343
ref: ${{ inputs.SOURCE_BRANCH }}
4444

45-
- name: Generate GitHub App token
46-
id: app-token
47-
uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
48-
with:
49-
app-id: ${{ secrets.DOCS_BOT_APP_ID }}
50-
private-key: ${{ secrets.DOCS_BOT_APP_PRIVATE_KEY }}
51-
owner: github
52-
repositories: docs-internal,models-gateway,docs-engineering
53-
5445
- uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
5546
with:
5647
# By default, only the most recent commit of the `main` branch
5748
# will be checked out
5849
repository: github/models-gateway
5950
path: models-gateway
6051
ref: main
61-
token: ${{ steps.app-token.outputs.token }}
52+
token: ${{ secrets.DOCS_BOT_PAT_BASE }}
6253

6354
- uses: ./.github/actions/node-npm-setup
6455

6556
- name: Sync the REST, Webhooks, and GitHub Apps schemas
6657
env:
6758
# Needed for gh
68-
GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
59+
GITHUB_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}
6960
NODE_OPTIONS: '--max-old-space-size=8192'
7061
run: |
7162
npm run sync-rest -- \
@@ -89,7 +80,7 @@ jobs:
8980
- name: Create pull request
9081
env:
9182
# Needed for gh
92-
GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
83+
GITHUB_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}
9384
run: |
9485
# If nothing to commit, exit now. It's fine. No orphans.
9586
changes=$(git diff --name-only | wc -l)
@@ -137,4 +128,4 @@ jobs:
137128
- uses: ./.github/actions/create-workflow-failure-issue
138129
if: ${{ failure() && github.event_name != 'workflow_dispatch' }}
139130
with:
140-
token: ${{ steps.app-token.outputs.token }}
131+
token: ${{ secrets.DOCS_BOT_PAT_BASE }}

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
# ---------------------------------------------------------------
1111
# To update the sha:
1212
# https://github.com/github/gh-base-image/pkgs/container/gh-base-image%2Fgh-base-noble
13-
FROM ghcr.io/github/gh-base-image/gh-base-noble:20260708-113537-g661fe65de@sha256:894162a6b21fc03da8ba889760592e6e223ba76f3067723f93bd1e49aff1c46b AS base
13+
FROM ghcr.io/github/gh-base-image/gh-base-noble:20260713-090615-gb0d388add@sha256:8708e26b53b2304cf8d933be5e8fbca4fa4d07b3ba6e4be238372a5d3029e443 AS base
1414

1515
# Install curl for Node install and determining the early access branch
1616
# Install git for cloning docs-early-access & translations repos
115 KB
Loading

content/account-and-profile/concepts/username-changes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ If the new owner of your old username creates a repository with the same name as
4343

4444
## Links to your previous profile page
4545

46-
After changing your username, links to your previous profile page, such as `https://{% data variables.product.product_url %}/previoususername`, will return a 404 error. We recommend updating any links to your profile from elsewhere{% ifversion fpt or ghec %}, such as your LinkedIn or Twitter profile{% endif %}.
46+
After changing your username, links to your previous profile page, such as `https://{% data variables.product.product_url %}/previoususername`, will return a 404 error. We recommend updating any links to your profile from elsewhere{% ifversion fpt or ghec %}, such as your LinkedIn or X (formerly Twitter) profile{% endif %}.
4747

4848
## Accounts logged in on {% data variables.product.prodname_mobile %}
4949

content/account-and-profile/tutorials/personalize-your-profile.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ Add pronouns to your public user profile to share information about yourself wit
9090
You can add up to four links to social accounts on your profile.
9191

9292
{% data reusables.user-settings.access_settings %}
93-
1. Under "Social accounts", in a blank "Link to social profile" field, type the full URL of the social account. For example, for the `@GitHub` Twitter account, type `https://twitter.com/github`.
93+
1. Under "Social accounts", in a blank "Link to social profile" field, type the full URL of the social account. For example, for the `@GitHub` X (formerly Twitter) account, type `https://x.com/github`.
9494
{% data reusables.profile.update-profile %}
9595

9696
{% endif %}

content/actions/concepts/billing-and-usage.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ contentType: concepts
1919
## About billing for {% data variables.product.prodname_actions %}
2020

2121
{% ifversion fpt or ghec %}
22-
{% data reusables.actions.actions-billing %} For more information, see [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions).
22+
{% data reusables.actions.actions-billing %} For more information, see [AUTOTITLE](/billing/concepts/product-billing/github-actions).
2323
{% else %}
24-
{% data variables.product.prodname_actions %} usage is free for {% data variables.product.prodname_ghe_server %} instances that use self-hosted runners. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners).
24+
{% data variables.product.prodname_actions %} usage is free for {% data variables.product.prodname_ghe_server %} instances that use self-hosted runners. For more information, see [AUTOTITLE](/actions/concepts/runners/self-hosted-runners).
2525
{% endif %}
2626

2727
{% ifversion fpt or ghec %}
@@ -34,15 +34,15 @@ contentType: concepts
3434

3535
## Usage limits and policy
3636

37-
There are several limits on {% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. See [AUTOTITLE](/actions/reference/actions-limits).
37+
There are several limits on {% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. See [AUTOTITLE](/actions/reference/limits).
3838

3939
In addition to the usage limits, you must ensure that you use {% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/free-pro-team@latest/site-policy/github-terms/github-terms-of-service). For more information on {% data variables.product.prodname_actions %}-specific terms, see the [GitHub Additional Product Terms](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#a-actions-usage).
4040

4141
{% ifversion fpt or ghec %}
4242

4343
## {% data variables.product.prodname_actions %} usage metrics
4444

45-
Organization owners and users with the "View organization Actions metrics" permission can view {% data variables.product.prodname_actions %} usage metrics for their organization. These metrics can help you understand how and where your Actions minutes are being used. For more information, see [AUTOTITLE](/enterprise-cloud@latest/organizations/collaborating-with-groups-in-organizations/viewing-usage-metrics-for-github-actions).
45+
Organization owners and users with the "View organization Actions metrics" permission can view {% data variables.product.prodname_actions %} usage metrics for their organization. These metrics can help you understand how and where your Actions minutes are being used. For more information, see [AUTOTITLE](/enterprise-cloud@latest/organizations/collaborating-with-groups-in-organizations/viewing-github-actions-metrics-for-your-organization).
4646

4747
When you view usage metrics, it is important to remember that {% data reusables.actions.actions-usage-metrics-not-billing-metrics %}
4848

@@ -52,12 +52,12 @@ When you view usage metrics, it is important to remember that {% data reusables.
5252

5353
If you reuse a workflow, billing is always associated with the caller workflow. Assignment of {% data variables.product.prodname_dotcom %}-hosted runners is always evaluated using only the caller's context. The caller cannot use {% data variables.product.prodname_dotcom %}-hosted runners from the called repository.
5454

55-
For more information see, [AUTOTITLE](/actions/using-workflows/reusing-workflows).
55+
For more information see, [AUTOTITLE](/actions/how-tos/reuse-automations/reuse-workflows).
5656

5757
## Next steps
5858

5959
You can manage your {% data variables.product.prodname_actions %} usage and retention policies for your repository, organization, or enterprise account. For more information, see:
6060
* [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)
6161
* [AUTOTITLE](/organizations/managing-organization-settings/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization)
6262
* [AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization)
63-
* [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise)
63+
* [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise)

0 commit comments

Comments
 (0)