Skip to content

Commit ed5cd72

Browse files
authored
Merge pull request #41918 from github/repo-sync
Repo sync
2 parents 35b4824 + 549c97c commit ed5cd72

File tree

36 files changed

+487
-174
lines changed

36 files changed

+487
-174
lines changed

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/contributing/writing-for-github-docs/using-yaml-frontmatter.md

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

@@ -269,15 +271,16 @@ journeyTracks:
269271
title: 'Getting started with {% data variables.product.prodname_actions %}'
270272
description: 'Learn the basics of GitHub Actions.'
271273
guides:
272-
- '/actions/quickstart'
273-
- '/actions/learn-github-actions'
274-
- '/actions/using-workflows'
274+
- href: '/actions/quickstart'
275+
- href: '/actions/learn-github-actions'
276+
alternativeNextStep: 'Want to skip ahead? See [AUTOTITLE](/actions/using-workflows).'
277+
- href: '/actions/using-workflows'
275278
- id: 'advanced'
276279
title: 'Advanced {% data variables.product.prodname_actions %}'
277280
description: 'Dive deeper into advanced features.'
278281
guides:
279-
- '/actions/using-workflows/workflow-syntax-for-github-actions'
280-
- '/actions/deployment/deploying-with-github-actions'
282+
- href: '/actions/using-workflows/workflow-syntax-for-github-actions'
283+
- href: '/actions/deployment/deploying-with-github-actions'
281284
```
282285

283286
### `type`

content/copilot/concepts/agents/code-review.md

Lines changed: 31 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,10 +37,29 @@ This article provides an overview of {% data variables.copilot.copilot_code-revi
3737
* Xcode
3838
* JetBrains IDEs
3939

40-
{% data variables.copilot.copilot_code-review_short %} is a premium feature, available with the {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, {% data variables.copilot.copilot_business_short %}, and {% data variables.copilot.copilot_enterprise_short %} plans. See [Copilot plans](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=text).
40+
{% data variables.copilot.copilot_code-review_short %} is a premium feature, available with the {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, {% data variables.copilot.copilot_business_short %}, and {% data variables.copilot.copilot_enterprise_short %} plans. See [{% data variables.product.prodname_copilot_short %} plans](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=text).
4141

4242
If you receive {% data variables.product.prodname_copilot_short %} from an organization then, to be able to request a pull request review from {% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %} or in {% data variables.product.prodname_mobile %}, the **{% data variables.copilot.copilot_code-review_short %}** option must be enabled in the {% data variables.product.prodname_copilot_short %} policy settings for the organization. See [AUTOTITLE](/copilot/how-tos/administer/organizations/managing-policies-for-copilot-in-your-organization).
4343

44+
## {% data variables.copilot.copilot_code-review_short %} without a {% data variables.product.prodname_copilot_short %} license
45+
46+
{% data variables.copilot.copilot_code-review_short %} is also available on {% data variables.product.prodname_dotcom_the_website %} for organization members **without a {% data variables.product.prodname_copilot_short %} license**, when enabled by an enterprise administrator or organization owner. This capability is available to organizations on the **{% data variables.copilot.copilot_business_short %}** and **{% data variables.copilot.copilot_enterprise_short %}** plans.
47+
48+
To allow organization members without a {% data variables.product.prodname_copilot_short %} license to use {% data variables.copilot.copilot_code-review_short %}, you must enable two policies:
49+
50+
1. **Premium request paid usage**. This must be enabled first. It allows the enterprise or organization to incur charges for {% data variables.copilot.copilot_code-review_short %} premium request usage.
51+
1. **Allow members without a {% data variables.product.prodname_copilot_short %} license to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_dotcom_the_website %}**. This sub-policy enables {% data variables.copilot.copilot_code-review_short %} for users without a license.
52+
53+
* This policy is **disabled by default**.
54+
* Once this policy is set at the enterprise level, it becomes **visible (but not editable)** at the organization level.
55+
* The policy is **most restrictive**, meaning {% data variables.copilot.copilot_code-review_short %} is only available in repositories where the policy is explicitly enabled.
56+
57+
When both policies are enabled, users without a {% data variables.product.prodname_copilot_short %} license can request a {% data variables.copilot.copilot_code-review_short %} review on their pull requests in the organization’s repositories.
58+
59+
In addition, in repositories where automatic code review is enabled, {% data variables.product.prodname_copilot_short %} automatically reviews all pull requests, regardless of whether the author has a {% data variables.product.prodname_copilot_short %} license.
60+
61+
{% data variables.copilot.copilot_code-review_short %} for users without a license is **not available in IDEs** or in organizations that do not have these policies enabled.
62+
4463
## Excluded files
4564

4665
Dependency management files (such as package.json and Gemfile.lock) and certain other types of files (such as log files and SVGs) are excluded from {% data variables.copilot.copilot_code-review_short %}. If you include any of these files in a pull request, {% data variables.copilot.copilot_code-review_short %} will not consider the file when carrying out the review. Similarly, using {% data variables.copilot.copilot_code-review_short %} on one of these files in your IDE, will not generate review comments.
@@ -52,10 +71,11 @@ For more information, see [AUTOTITLE](/copilot/reference/review-excluded-files).
5271
> [!NOTE]
5372
>
5473
> * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply to your use of this product.
55-
> * These tools are enabled automatically for {% data variables.copilot.copilot_pro %} or {% data variables.copilot.copilot_pro_plus %} plans.
56-
> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled **Copilot in GitHub.com > Opt in to preview features** in the **{% data variables.product.prodname_copilot %} policies** page of the organization or enterprise settings. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
74+
> * {% data variables.copilot.copilot_code-review_short %} has several new tools that are in {% data variables.release-phases.public_preview %} and subject to change.
75+
76+
These new tools are enabled automatically for {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plans.
5777

58-
{% data variables.copilot.copilot_code-review_short %} has several new tools that are in {% data variables.release-phases.public_preview %} and subject to change.
78+
If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled **{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} > Opt in to preview features** in the **{% data variables.product.prodname_copilot %} policies** page of the organization or enterprise settings. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
5979

6080
* **Full project context gathering** to provide more specific, accurate, and contextually aware code reviews.
6181
* **Support for static analysis tools like {% data variables.product.prodname_codeql %}, ESLint, and PMD** to deliver more high-signal, consistent findings for security and quality.
@@ -73,12 +93,18 @@ In the event that {% data variables.product.prodname_actions %} is unavailable o
7393
7494
## Code review monthly quota
7595

76-
Each time {% data variables.product.prodname_copilot_short %} reviews a pull request, or reviews code in your IDE, your monthly quota of Copilot premium requests is reduced by one.
96+
Each time {% data variables.product.prodname_copilot_short %} reviews a pull request, or reviews code in your IDE, your monthly quota of {% data variables.product.prodname_copilot_short %} premium requests is reduced by one.
7797

7898
If a repository is configured to automatically request a code review from {% data variables.product.prodname_copilot_short %} for all new pull requests, the premium request usage is applied to the quota of the pull request author. If a pull request is created by {% data variables.product.prodname_actions %} or by a bot, the usage will apply to the user who triggered the workflow (if identifiable), or to a designated billing owner.
7999

80100
When you reach your monthly quota you will not be able to get a code review from {% data variables.product.prodname_copilot_short %} until your quota resets—unless you upgrade your {% data variables.product.prodname_copilot_short %} plan or enable additional premium requests.
81101

102+
### Quota for users without a {% data variables.product.prodname_copilot_short %} license
103+
104+
Users without a {% data variables.product.prodname_copilot_short %} license do not have a monthly premium request quota. When {% data variables.copilot.copilot_code-review_short %} is enabled for these users through the “Allow members without a {% data variables.product.prodname_copilot_short %} license to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_dotcom_the_website %}” policy, any premium requests they generate—either by manually requesting a review or through automatic code review—are billed directly to the organization or enterprise as paid overage usage.
105+
106+
Premium requests generated by users without a license are not attributed to any {% data variables.product.prodname_copilot_short %} plan quota and appear as overage usage in billing reports and premium request analytics. Users with a {% data variables.product.prodname_copilot_short %} license continue to consume premium requests from their assigned plan quota.
107+
82108
## Model usage
83109

84110
{% data reusables.copilot.ccr-model-usage %}

content/copilot/how-tos/manage-and-track-spending/monitor-premium-requests.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,11 +58,11 @@ You can view an overview of your premium request usage at any time in your "Bill
5858

5959
### Viewing detailed analytics of your usage
6060

61+
{% data reusables.billing.premium-request-analytics-start %}
62+
6163
{% data reusables.user-settings.access_billing_settings_url %}
6264
1. In the side bar, click **Premium request analytics** to show detailed analytics.
6365
1. Use the filter, "Group by", and "Timeframe" options to change the data displayed in the chart and table.
64-
{% data reusables.billing.premium-request-analytics-start %}
65-
6666
1. Optionally, to download the data shown in the chart, click the {% octicon "kebab-horizontal" aria-label="Chart options" aria-hidden="true" %} button and select your preferred format.
6767

6868
![Screenshot of the usage chart on the "Premium request analytics" page with "Chart options" open and outlined in dark orange.](/assets/images/help/billing/premium-request-analytics-chart-download.png)

content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ For a full introduction to {% data variables.copilot.copilot_code-review %}, see
2828

2929
{% webui %}
3030

31+
{% data variables.copilot.copilot_code-review_short %} is also available for organization members without a {% data variables.product.prodname_copilot_short %} license, when enabled by an enterprise administrator or organization owner. See [{% data variables.copilot.copilot_code-review_short %} for organization members without a {% data variables.product.prodname_copilot_short %} license](/copilot/concepts/agents/code-review#copilot-code-review-for-organization-members-without-a-copilot-license).
32+
3133
## Using {% data variables.copilot.copilot_code-review_short %}
3234

3335
These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in the {% data variables.product.github %} website. To see instructions for other popular coding environments, click the appropriate tab at the top of the page.

content/copilot/reference/ai-models/model-comparison.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@ Use this table to find a suitable model quickly, see more detail in the sections
4242
| {% data variables.copilot.copilot_claude_opus_41 %} | Deep reasoning and debugging | Complex problem-solving challenges, sophisticated reasoning | Reasoning, vision | [{% data variables.copilot.copilot_claude_opus_41 %} model card](https://assets.anthropic.com/m/4c024b86c698d3d4/original/Claude-4-1-System-Card.pdf) |
4343
| {% data variables.copilot.copilot_claude_sonnet_40 %} | Deep reasoning and debugging | Performance and practicality, perfectly balanced for coding workflows | Agent mode, vision | [{% data variables.copilot.copilot_claude_sonnet_40 %} model card](https://www-cdn.anthropic.com/6be99a52cb68eb70eb9572b4cafad13df32ed995.pdf) |
4444
| {% data variables.copilot.copilot_gemini_25_pro %} | Deep reasoning and debugging | Complex code generation, debugging, and research workflows | Reasoning, vision | [{% data variables.copilot.copilot_gemini_25_pro %} model card](https://storage.googleapis.com/model-cards/documents/gemini-2.5-pro.pdf) |
45+
| {% data variables.copilot.copilot_gemini_3_flash %} | Fast help with simple or repetitive tasks | Fast, reliable answers to lightweight coding questions | Agent mode | Not available |
4546
| {% data variables.copilot.copilot_grok_code %} | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode | [{% data variables.copilot.copilot_grok_code %} model card](https://data.x.ai/2025-08-20-grok-4-model-card.pdf) |
4647
| {% data variables.copilot.copilot_qwen_25 %} | General-purpose coding and writing | Code generation, reasoning, and code repair / debugging | Reasoning | [{% data variables.copilot.copilot_qwen_25 %} model card](https://arxiv.org/pdf/2409.12186) |
4748
| {% data variables.copilot.copilot_raptor_mini %} | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode | Coming soon |

content/copilot/reference/ai-models/model-hosting.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,8 +72,9 @@ Used for:
7272

7373
* {% data variables.copilot.copilot_gemini_25_pro %}
7474
* {% data variables.copilot.copilot_gemini_3_pro %}
75+
* {% data variables.copilot.copilot_gemini_3_flash %}
7576

76-
{% data variables.product.prodname_copilot %} uses {% data variables.copilot.copilot_gemini_3_pro %} and {% data variables.copilot.copilot_gemini_25_pro %} hosted on Google Cloud Platform (GCP). When using {% data variables.copilot.copilot_gemini %} models, prompts and metadata are sent to GCP, which makes the [following data commitment](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance): _{% data variables.copilot.copilot_gemini %} doesn't use your prompts, or its responses, as data to train its models._
77+
{% data variables.product.prodname_copilot %} uses {% data variables.copilot.copilot_gemini_3_pro %}, {% data variables.copilot.copilot_gemini_3_flash %}, and {% data variables.copilot.copilot_gemini_25_pro %} hosted on Google Cloud Platform (GCP). When using {% data variables.copilot.copilot_gemini %} models, prompts and metadata are sent to GCP, which makes the [following data commitment](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance): _{% data variables.copilot.copilot_gemini %} doesn't use your prompts, or its responses, as data to train its models._
7778

7879
To provide better service quality and reduce latency, {% data variables.product.github %} uses [prompt caching](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance#customer_data_retention_and_achieving_zero_data_retention).
7980

0 commit comments

Comments
 (0)