Skip to content

Repo sync #39452

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jul 22, 2025
Merged

Repo sync #39452

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
1456e15
Fix oneOf nested fields rendering incorrectly in webhook docs (#56270)
heiskr Jul 22, 2025
7d51a67
Update docs changelog (for PR #56616) (#56760)
docs-bot Jul 22, 2025
a99718b
[EDI] Creating workflow templates for your organization (#56763)
guntrip Jul 22, 2025
e8c1c51
Update docs changelog (for PR #56555) (#56765)
docs-bot Jul 22, 2025
4ff81e8
Update CHANGELOG with new GraphQL API documentation
hubwriter Jul 22, 2025
4292194
Fix link formatting in CHANGELOG.md
hubwriter Jul 22, 2025
2143787
Add note that internal repositories have minimum access of read (#56710)
bss-mc Jul 22, 2025
49a6a68
Remove legal notice links, duplicated ARC intro (#56759)
subatoi Jul 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,29 @@
# Docs changelog

**16 July 2025**

We've added documentation describing how to use the GraphQL API to create a new issue and, in the same request, assign the issue to Copilot coding agent.

See: [Using Copilot to work on an issue](https://docs.github.com/copilot/how-tos/agents/copilot-coding-agent/using-copilot-to-work-on-an-issue#assigning-an-issue-to-copilot-via-the-github-api).

<hr>

**16 July 2025**

We've updated the Copilot documentation to coincide with the release of an improved user interface for configuring the firewall for Copilot coding agent.

See: [Customizing or disabling the firewall for Copilot coding agent](https://docs.github.com/en/copilot/how-tos/agents/copilot-coding-agent/customizing-or-disabling-the-firewall-for-copilot-coding-agent).

<hr>

**16 July 2025**

We've updated the Copilot docs to coincide with the release of issue form support for Copilot Chat. When you use Copilot Chat to create an issue, an issue form will be used if there's an appropriate one in the repo. Previously only issue templates were supported.

See [Using GitHub Copilot to create issues](https://docs.github.com/copilot/how-tos/github-flow/using-github-copilot-to-create-issues).

<hr>

**30 June 2025**

Many enterprise customers want to measure the downstream impact of Copilot on their company, looking beyond leading metrics like adoption and usage.
Expand Down
2 changes: 0 additions & 2 deletions content/actions/concepts/runners/about-actions-runner-controller.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,6 @@ redirect_from:
- /actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller
---

[Legal notice](#legal-notice)

## About {% data variables.product.prodname_actions_runner_controller %}

{% data reusables.actions.actions-runner-controller-about-arc %}
Expand Down
2 changes: 0 additions & 2 deletions content/actions/concepts/runners/about-runner-scale-sets.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,6 @@ topics:
- Actions Runner Controller
---

[Legal notice](#legal-notice)

## About runner scale sets

A runner scale set is a group of homogeneous runners that can be assigned jobs from {% data variables.product.prodname_actions %}. The number of active runners owned by a runner scale set can be controlled by auto-scaling runner solutions such as {% data variables.product.prodname_actions_runner_controller %} (ARC).
Expand Down
21 changes: 3 additions & 18 deletions ...ow-tos/sharing-automations/creating-workflow-templates-for-your-organization.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,29 +16,14 @@ type: tutorial
topics:
- Workflows
- CI
permissions: Write access to the organization's public `.github` repository. Templates can be used by organization members who have permission to create workflows.
---

{% data reusables.actions.enterprise-github-hosted-runners %}

## Overview

{% data reusables.actions.workflow-organization-templates %}

{% data reusables.actions.workflow-templates-categories %}

> [!NOTE]
> Because workflow templates require a public `.github` repository, they are not available for {% data variables.product.prodname_emus %}.

## Creating a workflow template

Workflow templates can be created by users with write access to the organization's _public_ `.github` repository. These can then be used by organization members who have permission to create workflows.

{% ifversion fpt %}
Workflow templates created by users can only be used to create workflows in public repositories. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/using-workflows/creating-starter-workflows-for-your-organization).
{% endif %}

> [!NOTE]
> To avoid duplication among workflow templates you can call reusable workflows from within a workflow. This can help make your workflows easier to maintain. For more information, see [AUTOTITLE](/actions/using-workflows/reusing-workflows).
> * Because workflow templates require a public `.github` repository, they are not available for {% data variables.product.prodname_emus %}.
> * To avoid duplication among workflow templates you can call reusable workflows from within a workflow. This can help make your workflows easier to maintain. For more information, see [AUTOTITLE](/actions/using-workflows/reusing-workflows).

This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the workflow templates will be presented to users when they are creating a new workflow.

Expand Down
2 changes: 0 additions & 2 deletions ...actions/reference/extending-github-actions-importer-with-custom-transformers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/extending-github-actions-importer-with-custom-transformers
---

[Legal notice](#legal-notice)

## About custom transformers

{% data variables.product.prodname_actions_importer %} offers the ability to extend its built-in mapping by creating custom transformers. Custom transformers can be used to:
Expand Down
2 changes: 0 additions & 2 deletions content/actions/reference/supplemental-arguments-and-settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,6 @@ redirect_from:
- /actions/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/supplemental-arguments-and-settings
---

[Legal notice](#legal-notice)

This article provides general information for configuring {% data variables.product.prodname_actions_importer %}'s supplemental arguments and settings, such as optional parameters, path arguments, and network settings.

## Optional parameters
Expand Down
2 changes: 0 additions & 2 deletions ...ons/tutorials/actions-runner-controller/authenticating-arc-to-the-github-api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,6 @@ redirect_from:
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/authenticating-to-the-github-api#deploying-using-personal-access-token-classic-authentication
---

[Legal notice](#legal-notice)

You can authenticate {% data variables.product.prodname_actions_runner_controller %} (ARC) to the {% data variables.product.prodname_dotcom %} API by using a {% data variables.product.prodname_github_app %} or by using a {% data variables.product.pat_v1 %}.

> [!NOTE]
Expand Down
2 changes: 0 additions & 2 deletions ...runner-controller/deploying-runner-scale-sets-with-actions-runner-controller.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,6 @@ redirect_from:
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller
---

[Legal notice](#legal-notice)

## Deploying a runner scale set

To deploy a runner scale set, you must have ARC up and running. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller).
Expand Down
8 changes: 0 additions & 8 deletions ...tutorials/actions-runner-controller/quickstart-for-actions-runner-controller.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,14 +15,6 @@ redirect_from:
- /actions/tutorials/quickstart-for-actions-runner-controller
---

[Legal notice](#legal-notice)

## Introduction

{% data reusables.actions.actions-runner-controller-about-arc %}

You can set up ARC on Kubernetes using Helm, then create and run a workflow that uses runner scale sets. For more information about runner scale sets, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller#runner-scale-set).

## Prerequisites

In order to use ARC, ensure you have the following.
Expand Down
2 changes: 0 additions & 2 deletions ...s/actions-runner-controller/troubleshooting-actions-runner-controller-errors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,6 @@ redirect_from:
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors
---

[Legal notice](#legal-notice)

## Logging

The {% data variables.product.prodname_actions_runner_controller %} (ARC) resources, which include the controller, listener, and runners, write logs to standard output (`stdout`). We recommend you implement a logging solution to collect and store these logs. Having logs available can help you or GitHub support with troubleshooting and debugging. For more information, see [Logging Architecture](https://kubernetes.io/docs/concepts/cluster-administration/logging/) in the Kubernetes documentation.
Expand Down
2 changes: 0 additions & 2 deletions ...ions-runner-controller/using-actions-runner-controller-runners-in-a-workflow.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,6 @@ redirect_from:
- /actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/using-actions-runner-controller-runners-in-a-workflow
---

[Legal notice](#legal-notice)

## Using ARC runners in a workflow file

To assign jobs to run on a runner scale set, you can specify the name of the scale set as the value for the `runs-on` key in your {% data variables.product.prodname_actions %} workflow file.
Expand Down
2 changes: 0 additions & 2 deletions ...ter-to-automate-migrations/automating-migration-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,6 @@ shortTitle: 'Automate migration with {% data variables.product.prodname_actions_

{% data reusables.actions.enterprise-github-hosted-runners %}

[Legal notice](#legal-notice)

## About {% data variables.product.prodname_actions_importer %}

You can use {% data variables.product.prodname_actions_importer %} to plan and automatically migrate your CI/CD supported pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...automate-migrations/migrating-from-azure-devops-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-azure-devops-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from Azure DevOps with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate Azure DevOps pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...er-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bamboo-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from Bamboo with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate Bamboo pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...e-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-bitbucket-pipelines-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from Bitbucket Pipelines with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate Bitbucket Pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...-to-automate-migrations/migrating-from-circleci-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-circleci-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from CircleCI with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate CircleCI pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...er-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-gitlab-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from GitLab with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate GitLab pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...r-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-jenkins-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from Jenkins with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate Jenkins pipelines to {% data variables.product.prodname_actions %}.
Expand Down
2 changes: 0 additions & 2 deletions ...to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ redirect_from:
- /actions/how-tos/migrating-to-github-actions/using-github-actions-importer-to-automate-migrations/migrating-from-travis-ci-with-github-actions-importer
---

[Legal notice](#legal-notice)

## About migrating from Travis CI with GitHub Actions Importer

The instructions below will guide you through configuring your environment to use {% data variables.product.prodname_actions_importer %} to migrate Travis CI pipelines to {% data variables.product.prodname_actions %}.
Expand Down
3 changes: 3 additions & 0 deletions ...-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,9 @@ Across all organizations owned by your enterprise, you can set a base repository
1. Under "Base permissions", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
1. Under "Base permissions", select the dropdown menu and click a policy.

> [!NOTE]
> Internal repositories have a minimum visibility level of read, even if the base permission has been set to none.

## Enforcing a policy for repository creation

Across all organizations owned by your enterprise, you can allow members to create repositories, restrict repository creation to organization owners, or allow owners to administer the setting on the organization level.
Expand Down
1 change: 1 addition & 0 deletions ...ories/managing-repository-roles/setting-base-permissions-for-an-organization.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ If you've created a custom repository role with an inherited role that is lower
> [!NOTE]
> * All changes to base permissions will affect both new and existing members.
> * {% data reusables.repositories.org-base-permissions-private-forks %}
> * Internal repositories have a minimum visibility level of read, even if the base permission has been set to none.

## Setting base permissions

Expand Down
64 changes: 42 additions & 22 deletions src/rest/scripts/utils/get-body-params.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,19 @@ async function getTopLevelOneOfProperty(
}

// Gets the body parameters for a given schema recursively.
// Helper function to handle oneOf fields where all items are objects
async function handleObjectOnlyOneOf(
param: Schema,
paramType: string[],
): Promise<TransformedParam[]> {
if (param.oneOf && param.oneOf.every((object: TransformedParam) => object.type === 'object')) {
paramType.push('object')
param.oneOfObject = true
return await getOneOfChildParams(param)
}
return []
}

export async function getBodyParams(schema: Schema, topLevel = false): Promise<TransformedParam[]> {
const bodyParametersParsed: TransformedParam[] = []
const schemaObject = schema.oneOf && topLevel ? await getTopLevelOneOfProperty(schema) : schema
Expand Down Expand Up @@ -161,38 +174,45 @@ export async function getBodyParams(schema: Schema, topLevel = false): Promise<T
}
} else if (paramType.includes('object')) {
if (param.oneOf) {
if (param.oneOf.every((object: TransformedParam) => object.type === 'object')) {
param.oneOfObject = true
childParamsGroups.push(...(await getOneOfChildParams(param)))
const oneOfChildren = await handleObjectOnlyOneOf(param, paramType)
if (oneOfChildren.length > 0) {
childParamsGroups.push(...oneOfChildren)
}
} else {
childParamsGroups.push(...(await getBodyParams(param, false)))
}
} else if (param.oneOf) {
const descriptions: { type: string; description: string }[] = []
for (const childParam of param.oneOf) {
paramType.push(childParam.type)
if (!param.description) {
if (childParam.type === 'array') {
if (childParam.items.description) {
descriptions.push({
type: childParam.type,
description: childParam.items.description,
})
// Check if all oneOf items are objects - if so, treat this as a oneOfObject case
const oneOfChildren = await handleObjectOnlyOneOf(param, paramType)
if (oneOfChildren.length > 0) {
childParamsGroups.push(...oneOfChildren)
} else {
// Handle mixed types or non-object oneOf cases
const descriptions: { type: string; description: string }[] = []
for (const childParam of param.oneOf) {
paramType.push(childParam.type)
if (!param.description) {
if (childParam.type === 'array') {
if (childParam.items.description) {
descriptions.push({
type: childParam.type,
description: childParam.items.description,
})
}
} else {
if (childParam.description) {
descriptions.push({ type: childParam.type, description: childParam.description })
}
}
} else {
if (childParam.description) {
descriptions.push({ type: childParam.type, description: childParam.description })
}
descriptions.push({ type: param.type, description: param.description })
}
} else {
descriptions.push({ type: param.type, description: param.description })
}
// Occasionally, there is no parent description and the description
// is in the first child parameter.
const oneOfDescriptions = descriptions.length ? descriptions[0].description : ''
if (!param.description) param.description = oneOfDescriptions
}
// Occasionally, there is no parent description and the description
// is in the first child parameter.
const oneOfDescriptions = descriptions.length ? descriptions[0].description : ''
if (!param.description) param.description = oneOfDescriptions

// This is a workaround for an operation that incorrectly defines anyOf
// for a body parameter. We use the first object in the list of the anyOf array.
Expand Down
Loading
Loading
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy