Skip to content

Commit 3459fb8

Browse files
authored
Merge branch 'main' into patch-1
2 parents cb315c8 + 6aa28a5 commit 3459fb8

File tree

156 files changed

+3339
-1233
lines changed

Some content is hidden

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

156 files changed

+3339
-1233
lines changed

.github/agents/readability-editor.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@ You are an expert editor for the GitHub Docs content team. Your job is to maximi
3636
- When two possible phrasings are equally clear, choose the one with fewer words. Brevity directly improves readability.
3737
- Use full terms and not their shortened versions.
3838
- Use active voice and personal pronouns ("you," "your"); favor present tense.
39+
- When “you can” introduces an instruction and does not convey optionality or permission, replace it with an active verb. For example, “You can enable” becomes “Enable”. Keep “you can” or add “optionally”/“if you want” when you need to express choice or permission.
3940
- Retain essential technical details, such as defaults, warnings, and admin options.
4041
- Do not alter the intent of verbs and actions (ex. "navigate" does not necessarily mean "select").
4142
- Start at least half of steps or instructions with a direct verb, unless another structure improves clarity.

.github/workflows/feedback-prompt.yml

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -53,22 +53,21 @@ jobs:
5353
.join(" ");
5454
5555
let commentBody;
56-
5756
if (assignees) {
5857
commentBody =
5958
"👋 " + assignees +
60-
" - Please leave us feedback on your contributing experience! " +
61-
"To do this, please go to `#docs-contributor-feedback` on Slack.";
59+
" - Thanks for your contribution! " +
60+
"If you think something could be improved about the contributor experience, please post in `#docs-contributor-feedback` on Slack.";
6261
} else if (prAuthor.toLowerCase() !== "copilot") {
6362
commentBody =
6463
"👋 @" + prAuthor +
65-
" - Please leave us feedback on your contributing experience! " +
66-
"To do this, please go to `#docs-contributor-feedback` on Slack.";
64+
" - Thanks for your contribution! " +
65+
"If you think something could be improved about the contributor experience, please post in `#docs-contributor-feedback` on Slack.";
6766
} else {
6867
// nobody to mention!
6968
commentBody =
70-
"👋 Please leave us feedback on your contributing experience! " +
71-
"To do this, please go to `#docs-contributor-feedback` on Slack.";
69+
"👋 Thanks for your contribution! " +
70+
"If you think something could be improved about the contributor experience, please post in `#docs-contributor-feedback` on Slack.";
7271
}
7372
7473
await github.rest.issues.createComment({

.github/workflows/index-general-search.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ jobs:
152152
153153
# first sleep to give it a chance to start
154154
sleep 6
155-
curl --retry-connrefused --retry 4 -I http://localhost:4002/
155+
curl --retry-connrefused --retry 6 -I http://localhost:4002/
156156
157157
- if: ${{ failure() }}
158158
name: Debug server outputs on errors
@@ -232,7 +232,7 @@ jobs:
232232

233233
- name: Upload failures artifact
234234
if: ${{ steps.check-failures.outputs.has_failures == 'true' }}
235-
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
235+
uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
236236
with:
237237
name: search-failures-${{ matrix.language }}
238238
path: /tmp/records/failures-summary.json
@@ -254,7 +254,7 @@ jobs:
254254
uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
255255

256256
- name: Download all failure artifacts
257-
uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
257+
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
258258
with:
259259
pattern: search-failures-*
260260
path: /tmp/failures

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# GitHub Docs <!-- omit in toc -->
22

3-
Welcome to GitHub Docs! GitHub’s documentation is open source, meaning anyone from inside or outside the company can contribute. For full contributing guidelines, visit our [contributing guide](https://docs.github.com/en/contributing)
3+
Welcome to GitHub Docs! GitHub’s documentation is open source, meaning anyone from inside or outside the company can contribute. For full contributing guidelines, visit our [contributing guide](https://docs.github.com/en/contributing).
4+
45

56
## Quick links by contributor type
67

130 KB
Loading

content/actions/how-tos/manage-runners/larger-runners/control-access.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Runner groups are used to control which repositories can run jobs on your {% dat
2727
* **Runners at the enterprise level:** {% data reusables.actions.about-enterprise-level-runner-groups %}
2828
* **Runners at the organization level:** {% data reusables.actions.about-organization-level-runner-groups %}
2929

30-
For example, the following diagram has a runner group named `grp-ubuntu-20.04-16core` at the enterprise level. Before the repository named `octo-repo` can use the runners in the group, you must first configure the group at the enterprise level to allow access to the `octo-org` organization. You must then configure the group at the organization level to allow access to `octo-repo`.
30+
For example, the following diagram has a runner group named `grp-ubuntu-24.04-16core` at the enterprise level. Before the repository named `octo-repo` can use the runners in the group, you must first configure the group at the enterprise level to allow access to the `octo-org` organization. You must then configure the group at the organization level to allow access to `octo-repo`.
3131

3232
![Diagram showing a runner group defined at the enterprise level with an organization configuration that allows access for two repositories.](/assets/images/help/actions/hosted-runner-mgmt.png)
3333

content/actions/how-tos/manage-runners/larger-runners/use-larger-runners.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -85,15 +85,15 @@ Use the labels in the table below to run your workflows on the corresponding mac
8585

8686
{% data reusables.actions.runner-labels-implicit %}
8787

88-
In this example, the `runs-on` key sends the job to any available runner that has been assigned the `ubuntu-20.04-16core` label:
88+
In this example, the `runs-on` key sends the job to any available runner that has been assigned the `ubuntu-24.04-16core` label:
8989

9090
```yaml
9191
name: learn-github-actions
9292
on: [push]
9393
jobs:
9494
check-bats-version:
9595
runs-on:
96-
labels: ubuntu-20.04-16core
96+
labels: ubuntu-24.04-16core
9797
steps:
9898
- uses: {% data reusables.actions.action-checkout %}
9999
- uses: {% data reusables.actions.action-setup-node %}
@@ -148,7 +148,7 @@ name: learn-github-actions-testing
148148
on: [push]
149149
jobs:
150150
build:
151-
runs-on: macos-13-xlarge
151+
runs-on: macos-26-xlarge
152152
steps:
153153
- uses: {% data reusables.actions.action-checkout %}
154154
- name: Build

content/actions/reference/runners/github-hosted-runners.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,9 @@ Single-CPU {% data variables.product.github %}-hosted runners are available in b
5050

5151
`ubuntu-slim` runners execute Actions workflows in Ubuntu Linux, inside a container rather than a full VM instance. When the job begins, {% data variables.product.github %} automatically provisions a new container for that job. All steps in the job execute in the container, allowing the steps in that job to share information using the runner's file system. When the job has finished, the container is automatically decommissioned. Each container provides hypervisor level 2 isolation.
5252

53+
> [!NOTE]
54+
> The container for `ubuntu-slim` runners runs in unprivileged mode. This means that some operations requiring elevated privileges—such as mounting file systems, using Docker-in-Docker, or accessing low-level kernel features—are not supported.
55+
5356
A minimal set of tools is installed on the `ubuntu-slim` runner image, appropriate for lightweight tasks. For details on what software is installed on the `ubuntu-slim` image, see the [README file](https://github.com/actions/runner-images/blob/main/images/ubuntu-slim/ubuntu-slim-Readme.md) in the `actions/runner-images` repository.
5457

5558
#### Usage limits

content/actions/reference/workflows-and-actions/workflow-syntax.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -953,7 +953,7 @@ jobs:
953953
example_matrix:
954954
strategy:
955955
matrix:
956-
os: [ubuntu-22.04, ubuntu-20.04]
956+
os: [ubuntu-22.04, ubuntu-24.04]
957957
version: [10, 12, 14]
958958
runs-on: {% raw %}${{ matrix.os }}{% endraw %}
959959
steps:

content/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/configuring-custom-footers.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,7 @@ You can configure the web UI for your enterprise to display a custom footer with
2222

2323
{% data reusables.enterprise-accounts.access-enterprise %}
2424
{% data reusables.enterprise-accounts.settings-tab %}
25-
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **Profile**.
26-
1. At the top of the page, under the navigation bar, click **Custom footer**.
27-
28-
![Screenshot of the "Profile" page for an enterprise account. A tab, labeled "Custom footer", is outlined in dark orange.](/assets/images/enterprise/custom-footer/custom-footer-section.png)
25+
1. Under **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Settings**, click **General**.
26+
1. Navigate to **Custom footer**.
2927
1. Under each "Footer Link" heading, type a title and URL.
30-
1. To save the content and display the custom footer, click **Update custom footer**.
28+
1. To save the content and display the custom footer, click **Update footer**.

0 commit comments

Comments
 (0)