Skip to content

Commit ef75db6

Browse files
Merge branch 'main' into rhysd-patch-1
2 parents 9aaaa90 + a93e027 commit ef75db6

File tree

201 files changed

+17202
-81213
lines changed

Some content is hidden

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

201 files changed

+17202
-81213
lines changed

.github/workflows/generate-code-scanning-query-lists.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ jobs:
8989
done
9090
9191
- name: Upload security query lists
92-
uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
92+
uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
9393
with:
9494
name: security-query-lists
9595
path: data/reusables/code-scanning/codeql-query-tables/
@@ -151,7 +151,7 @@ jobs:
151151
done
152152
153153
- name: Upload quality query lists
154-
uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4.3.3
154+
uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
155155
with:
156156
name: quality-query-lists
157157
path: data/reusables/code-quality/codeql-query-tables/
@@ -181,13 +181,13 @@ jobs:
181181
echo "Copied files from github/codeql repo. Commit SHA: $OPENAPI_COMMIT_SHA"
182182
183183
- name: Download security query lists
184-
uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
184+
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
185185
with:
186186
name: security-query-lists
187187
path: data/reusables/code-scanning/codeql-query-tables/
188188

189189
- name: Download quality query lists
190-
uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4.1.7
190+
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
191191
with:
192192
name: quality-query-lists
193193
path: data/reusables/code-quality/codeql-query-tables/

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
# Docs changelog
22

3+
**18 December 2025**
4+
5+
The documentation has been updated to reflect the general availability of direct organization billing for premium request usage in Copilot Code Review. Organization members without a Copilot plan can now use Copilot Code Review on GitHub.com, with premium request usage billed directly to their organization or enterprise. See [Copilot code review without a Copilot license](https://docs.github.com/en/copilot/concepts/agents/code-review#copilot-code-review-without-a-copilot-license).
6+
7+
<hr>
8+
39
**16 December 2025**
410

511
We've added [a tutorial](https://docs.github.com/copilot/tutorials/modernize-java-applications) on how Copilot can help modernize and migrate Java applications by assessing your codebase, identifying upgrade paths, and automating remediation and containerization tasks.

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
# ---------------------------------------------------------------
99
# To update the sha:
1010
# https://github.com/github/gh-base-image/pkgs/container/gh-base-image%2Fgh-base-noble
11-
FROM ghcr.io/github/gh-base-image/gh-base-noble:20251119-090131-gb27dc275c AS base
11+
FROM ghcr.io/github/gh-base-image/gh-base-noble:20251217-105955-g05726ec4c AS base
1212

1313
# Install curl for Node install and determining the early access branch
1414
# Install git for cloning docs-early-access & translations repos

assets/example-scripts/billing/README.md

Lines changed: 0 additions & 76 deletions
This file was deleted.

content/README.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -259,7 +259,9 @@ includeGuides:
259259
- `id` (required): Unique identifier for the journey. The id only needs to be unique for journeys within a single journey landing page.
260260
- `title` (required): Display title for the journey (supports Liquid variables)
261261
- `description` (optional): Description of the journey (supports Liquid variables)
262-
- `guides` (required): Array of article paths that make up this journey
262+
- `guides` (required): Array of guide objects that make up this journey. Each guide object has:
263+
- `href` (required): Path to the article
264+
- `alternativeNextStep` (optional): Custom text to guide users to alternative paths in the journey. Supports Liquid variables and `[AUTOTITLE]`.
263265
- Only applicable when used with `layout: journey-landing`.
264266
- Optional.
265267

@@ -271,15 +273,16 @@ journeyTracks:
271273
title: 'Getting started with {% data variables.product.prodname_actions %}'
272274
description: 'Learn the basics of GitHub Actions.'
273275
guides:
274-
- '/actions/quickstart'
275-
- '/actions/learn-github-actions'
276-
- '/actions/using-workflows'
276+
- href: '/actions/quickstart'
277+
- href: '/actions/learn-github-actions'
278+
alternativeNextStep: 'Want to skip ahead? See [AUTOTITLE](/actions/using-workflows).'
279+
- href: '/actions/using-workflows'
277280
- id: 'advanced'
278281
title: 'Advanced {% data variables.product.prodname_actions %}'
279282
description: 'Dive deeper into advanced features.'
280283
guides:
281-
- '/actions/using-workflows/workflow-syntax-for-github-actions'
282-
- '/actions/deployment/deploying-with-github-actions'
284+
- href: '/actions/using-workflows/workflow-syntax-for-github-actions'
285+
- href: '/actions/deployment/deploying-with-github-actions'
283286
```
284287

285288
### `type`

content/actions/concepts/runners/self-hosted-runners.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,19 +18,14 @@ topics:
1818
- CD
1919
---
2020

21-
{% data reusables.actions.self-hosted-price-note %}
22-
2321
A self-hosted runner is a system that you deploy and manage to execute jobs from {% data variables.product.prodname_actions %} on {% data variables.product.github %}.
2422

2523
Self-hosted runners:
2624

2725
{% ifversion fpt or ghec %}
2826
* Give you more control of hardware, operating system, and software tools than {% data variables.product.github %}-hosted runners provide. Be aware that you are responsible for updating the operating system and all other software.
29-
* Allow you to use machines and services that your company already maintains and pays to use.{% endif %} {% ifversion actions-cloud-platform-march %}
30-
* Add little to your bill for actions usage because you pay only for using the actions cloud platform. See [AUTOTITLE](/billing/concepts/product-billing/github-actions).{% elsif fpt or ghec %}
31-
* Are currently free to use with {% data variables.product.prodname_actions %}. From {% data variables.actions.self_hosted_runner_charge_date %}, you will see a small per-minute charge for using the actions cloud platform in your bill for actions usage. See [AUTOTITLE](/billing/concepts/product-billing/github-actions).{% endif %} {% ifversion ghes %}
27+
* Allow you to use machines and services that your company already maintains and pays to use.{% endif %}
3228
* Are free to use with {% data variables.product.prodname_actions %}, but you are responsible for the cost of maintaining your runner machines.
33-
* Can use cloud services or local machines that you already pay for.{% endif %}
3429
* Let you create custom hardware configurations that meet your needs with processing power or memory to run larger jobs, install software available on your local network.
3530
* Receive automatic updates for the self-hosted runner application only, though you may disable automatic updates of the runner.
3631
* Don't need to have a clean instance for every job execution.{% ifversion ghec or ghes %}

content/actions/how-tos/manage-runners/self-hosted-runners/add-runners.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,6 @@ Before you add a self-hosted runner, you should understand what they are and how
2929
Additionally, you must meet the following requirements:
3030
{% data reusables.actions.self-hosted-runners-prerequisites %}
3131

32-
{% data reusables.actions.self-hosted-price-note %}
33-
3432
## Adding a self-hosted runner to a repository
3533

3634
You can add self-hosted runners to a single repository. To add a self-hosted runner to a user repository, you must be the repository owner. For an organization repository, {% ifversion custom-org-roles %}you must be an organization owner, have admin access to the repository, or have the “Manage organization runners and runner groups” permission.{% else %}you must be an organization owner or have admin access to the repository.{% endif %}

content/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,6 @@ versions:
1515
ghec: '*'
1616
---
1717

18-
{% data reusables.actions.self-hosted-price-note %}
19-
2018
{% data reusables.actions.enterprise-github-hosted-runners %}
2119

2220
{% ifversion repository-actions-runners %}

content/actions/how-tos/manage-runners/use-proxy-servers.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,7 @@ contentType: how-tos
2222

2323
If your runner needs to communicate via a proxy server, you can configure proxy settings using environment variables or system-level configurations.
2424

25-
| Variable | Description | Example |
26-
| ------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
27-
| `https_proxy` | Proxy URL for HTTPS traffic. You can include basic authentication if required. | `http://proxy.local`<br>`http://192.168.1.1:8080`<br>`http://username:[email protected]` |
28-
| `http_proxy` | Proxy URL for HTTP traffic. You can include basic authentication if required. | `http://proxy.local`<br>`http://192.168.1.1:8080`<br>`http://username:[email protected]` |
29-
| `no_proxy` | A comma-separated list of hosts or IP addresses that should bypass the proxy. Some clients only honor IP addresses when connections are made directly to the IP rather than a hostname. | `example.com`<br>`example.com,myserver.local:443,example.org` |
25+
{% data reusables.actions.actions-proxy-environment-variables-table %}
3026

3127
The proxy environment variables are read when the runner application starts, so you must set the environment variables before configuring or starting the runner application. If your proxy configuration changes, you must restart the runner application.
3228

content/actions/how-tos/reuse-automations/create-workflow-templates.md

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,47 @@ This procedure demonstrates how to create a workflow template and metadata file.
2828
1. If it doesn't already exist, create a new repository named `.github` in your organization.
2929
1. Create a directory named `workflow-templates`.
3030
1. Create your new workflow file inside the `workflow-templates` directory.
31-
1. Create a metadata file inside the `workflow-templates` directory.
31+
32+
If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created the placeholder will be automatically replaced with the name of the repository's default branch.
33+
34+
{% ifversion ghes %}
35+
36+
> [!NOTE]
37+
> The following values in the `runs-on` key are also treated as placeholders:
38+
>
39+
> * `ubuntu-latest` is replaced with `[ self-hosted ]`
40+
> * `windows-latest` is replaced with `[ self-hosted, windows ]`
41+
> * `macos-latest` is replaced with `[ self-hosted, macOS ]`
42+
{% endif %}
43+
44+
For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow.
45+
46+
```yaml copy
47+
name: Octo Organization CI
48+
49+
on:
50+
push:
51+
branches: [ $default-branch ]
52+
pull_request:
53+
branches: [ $default-branch ]
54+
55+
jobs:
56+
build:
57+
runs-on: ubuntu-latest
58+
59+
steps:
60+
- uses: {% data reusables.actions.action-checkout %}
61+
62+
- name: Run a one-line script
63+
run: echo Hello from Octo Organization
64+
```
65+
66+
1. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`:
67+
68+
{% data reusables.actions.workflow-templates-metadata-example %}
69+
70+
{% data reusables.actions.workflow-templates-metadata-keys %}
71+
3272
1. To add another workflow template, add your files to the same `workflow-templates` directory.
3373

3474
## Next steps

0 commit comments

Comments
 (0)