Merge pull request #44419 from github/repo-sync

Repo sync

Author: docs-bot

assets/images/help/copilot/copilot-sdk/agent-loop-architecture.png

@@ -29,6 +29,11 @@ The token is also available in the `github.token` context. For more information,
 
 {% data reusables.actions.actions-do-not-trigger-workflows %}
 
+{% ifversion actions-github-token-pull-request-approval %}
+> [!NOTE]
+> If you need workflow runs from workflow-created pull requests to execute without requiring approval, use a {% data variables.product.prodname_github_app %} installation access token or a {% data variables.product.pat_generic %} instead of `GITHUB_TOKEN` when creating or updating the pull request.
+{% endif %}
+
 {% data reusables.actions.actions-do-not-trigger-pages-rebuilds %}
 
 ## Next steps

assets/images/help/copilot/copilot-sdk/agent-loop-event-flow.png

@@ -25,7 +25,7 @@ To learn more about workflows and triggering workflows, see [AUTOTITLE](/actions
 
 {% data reusables.actions.actions-do-not-trigger-workflows %} For more information, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication).
 
-If you do want to trigger a workflow from within a workflow run, you can use a {% data variables.product.prodname_github_app %} installation access token or a {% data variables.product.pat_generic %} instead of `GITHUB_TOKEN` to trigger events that require a token.
+If you do want to trigger a workflow from within a workflow run, you can use a {% data variables.product.prodname_github_app %} installation access token or a {% data variables.product.pat_generic %} instead of `GITHUB_TOKEN` to trigger events that require a token.{% ifversion actions-github-token-pull-request-approval %} Using one of these alternatives also lets `pull_request` workflows run automatically (without the approval prompt described above) when the pull request is created or updated by automation.{% endif %}
 
 If you use a {% data variables.product.prodname_github_app %}, you'll need to create a {% data variables.product.prodname_github_app %} and store the app ID and private key as secrets. For more information, see [AUTOTITLE](/apps/creating-github-apps/guides/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow). If you use a {% data variables.product.pat_generic %}, you'll need to create a {% data variables.product.pat_generic %} and store it as a secret. For more information about creating a {% data variables.product.pat_generic %}, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token). For more information about storing secrets, see [AUTOTITLE](/actions/security-guides/using-secrets-in-github-actions).
 

assets/images/help/copilot/copilot-sdk/agent-loop-tool-use-loop.png

@@ -510,7 +510,8 @@ on:
 > [!NOTE]
 > * {% data reusables.developer-site.multiple_activity_types %} For information about each activity type, see [AUTOTITLE](/webhooks-and-events/webhooks/webhook-events-and-payloads#pull_request). By default, a workflow only runs when a `pull_request` event's activity type is `opened`, `synchronize`, or `reopened`. To trigger workflows by different activity types, use the `types` keyword. For more information, see [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#onevent_nametypes).
 > * Workflows will not run on `pull_request` activity if the pull request has a merge conflict. The merge conflict must be resolved first. Conversely, workflows with the `pull_request_target` event will run even if the pull request has a merge conflict. Before using the `pull_request_target` trigger, you should be aware of the security risks. For more information, see [`pull_request_target`](#pull_request_target).
-> * The `pull_request` webhook event payload is empty for merged pull requests and pull requests that come from forked repositories.
+> * The `pull_request` webhook event payload is empty for merged pull requests and pull requests that come from forked repositories.{% ifversion actions-github-token-pull-request-approval %}
+> * When a pull request is created or updated by a workflow using `GITHUB_TOKEN`, `pull_request` events with the `opened`, `synchronize`, or `reopened` activity types create workflow runs that require approval. A user with write access to the repository can approve these runs from the pull request page. With the exception of `workflow_dispatch` and `repository_dispatch`, other `GITHUB_TOKEN`-triggered events do not create workflow runs at all.{% endif %}
 > * The value of `GITHUB_REF` varies for a closed pull request depending on whether the pull request has been merged or not. If a pull request was closed but not merged, it will be `refs/pull/PULL_REQUEST_NUMBER/merge`. If a pull request was closed as a result of being merged, it will be the fully qualified `ref` of the branch it was merged into, for example `/refs/heads/main`.
 
 Runs your workflow when activity on a pull request in the workflow's repository occurs. For example, if no activity types are specified, the workflow runs when a pull request is opened or reopened or when the head branch of the pull request is updated. For activity related to pull request reviews, pull request review comments, or pull request comments, use the [`pull_request_review`](#pull_request_review), [`pull_request_review_comment`](#pull_request_review_comment), or [`issue_comment`](#issue_comment) events instead. For information about the pull request APIs, see [AUTOTITLE](/graphql/reference/objects#pullrequest) in the GraphQL API documentation or [AUTOTITLE](/rest/pulls).

assets/images/help/copilot/copilot-sdk/bundled-cli-architecture.png

@@ -117,160 +117,6 @@ For more information about best practices, see [AUTOTITLE](/rest/overview/keepin
 
 If you selected an organization as the resource owner and the organization requires approval for {% data variables.product.pat_v2 %}s, then your token will be marked as `pending` until it is reviewed by an organization administrator. Your token will only be able to read public resources until it is approved. If you are an owner of the organization, your request is automatically approved. For more information, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/reviewing-and-revoking-personal-access-tokens-in-your-organization).
 
-### Pre-filling {% data variables.product.pat_v2 %} details using URL parameters
-
-You can share templates for a {% data variables.product.pat_v2 %} via links. Storing token details this way makes it easier to automate workflows and improve your developer experience by directing users to token creation with relevant fields already completed.
-
-Each supported field can be set using a specific query parameter. All parameters are optional and validated by the token generation form to ensure that the combinations of permissions and resource owner makes sense.
-
-An example URL template is shown here, with line breaks for legibility:
-
-```http copy
-https://github.com/settings/personal-access-tokens/new
-  ?name=Repo-reading+token
-  &description=Just+contents:read
-  &target_name=octodemo
-  &expires_in=45
-  &contents=read
-```
-
-Try the URL to create a token with `contents:read` and `metadata:read`, with the given name and description and an expiration date 45 days in the future. You'll see an error message indicating `Cannot find the specified resource owner: octodemo` because you're not a member of the `octodemo` organization.
-
-Below are some example URLs that generate the tokens we see most often:
-
-* [Read repo contents](https://github.com/settings/personal-access-tokens/new?name=Repo-reading+token&description=Just+contents:read&contents=read)
-* [Push access to repos](https://github.com/settings/personal-access-tokens/new?name=Repo-writing+token&description=Just+contents:write&contents=write)
-* [GitHub Models access](https://github.com/settings/personal-access-tokens/new?name=GitHub+Models+token&description=Used%20to%20call%20GitHub%20Models%20APIs%20to%20easily%20run%20LLMs%3A%20https%3A%2F%2Fdocs.github.com%2Fgithub-models%2Fquickstart%23step-2-make-an-api-call&user_models=read)<!-- markdownlint-disable-line search-replace Custom rule -->
-* [Update code and open a PR](https://github.com/settings/personal-access-tokens/new?name=Core-loop+token&description=Write%20code%20and%20push%20it%20to%20main%21%20Includes%20permission%20to%20edit%20workflow%20files%20for%20Actions%20-%20remove%20%60workflows%3Awrite%60%20if%20you%20don%27t%20need%20to%20do%20that&contents=write&pull_requests=write&workflows=write)
-* [Manage Copilot licenses in an organization](https://github.com/settings/personal-access-tokens/new?name=Core-loop+token&description=Enable%20or%20disable%20copilot%20access%20for%20users%20with%20the%20Seat%20Management%20APIs%3A%20https%3A%2F%2Fdocs.github.com%2Frest%2Fcopilot%2Fcopilot-user-management%0ABe%20sure%20to%20select%20an%20organization%20for%20your%20resource%20owner%20below%21&organization_copilot_seat_management=write)<!-- markdownlint-disable-line search-replace Custom rule -->
-* [Make Copilot requests](https://github.com/settings/personal-access-tokens/new?name=Copilot+requests+token&description=Make%20Copilot%20API%20requests%20on%20behalf%20of%20the%20user%2C%20consuming%20premium%20requests%3A%20https%3A%2F%2Fdocs.github.com%2Fcopilot%2Fconcepts%2Fbilling%2Fcopilot-requests&user_copilot_requests=read)<!-- markdownlint-disable-line search-replace Custom rule -->
-
-#### Supported Query Parameters
-
-To create your own token template, follow the query parameter details provided in this table:
-
-| Parameter      | Type   | Example Value    | Valid Values | Description           |
-|----------------|--------|------------------|--------------|-----------------------|
-| `name`        | string | `Deploy%20Bot`    | ≤ 40 characters, URL-encoded | Pre-fills the token’s display name. |
-| `description` | string | `Used+for+deployments` |   ≤ 1024 chars, URL-encoded  | Pre-fills the description for the token. |
-| `target_name` | string | `octodemo`  |   User or organization slug  | Sets the token's resource target. This is the owner of the repositories that the token will be able to access. If not provided, defaults to the current user's account. |
-| `expires_in`  | integer| `30` or `none` | Integer between 1 and 366, or `none` | Days until expiration or `none` for non-expiring. If not provided, the default is 30 days, or less if the target has a token lifetime policy set. |
-| `<permission>` | string | `contents=read` | A series of permission and access levels. | The permissions the token should have. Permissions can be set to `read`, `write`, or `admin`, but not every permission supports each of those levels. |
-
-#### Permissions
-
-Each supported permission is set using its name as a query parameter, with the value specifying the desired access level. Valid access levels are `read`, `write`, and `admin`. Some permissions only support `read`, some only support `write`, and only a few have `admin`. Use as many permissions as needed, in the form `&contents=read&pull_requests=write&...`.
-
-You do not need to include both `read` and `write` for a permission in your URL—`write` always includes `read`, and `admin` always includes `write`.
-
-##### Account Permissions
-
-Account permissions are only used when the current user is set as the resource owner.
-
-| Parameter name | Display name  | Access levels |
-|---|---|---|
-| `blocking` | Block another user | `read`, `write` |
-| `codespaces_user_secrets` | Codespaces user secrets | `read`, `write` |
-| `copilot_messages` | Copilot Chat | `read` |
-| `copilot_editor_context` | Copilot Editor Context | `read` |
-| `copilot_requests` | Copilot requests | `write` |
-| `emails` | Email addresses | `read`, `write` |
-| `user_events` | Events | `read` |
-| `followers` | Followers | `read`, `write` |
-| `gpg_keys` | GPG keys | `read`, `write` |
-| `gists` | Gists | `write` |
-| `keys` | Git SSH keys | `read`, `write` |
-| `interaction_limits` | Interaction limits | `read`, `write` |
-| `knowledge_bases` | Knowledge bases | `read`, `write` |
-| `user_models` | Models | `read` |
-| `plan` | Plan | `read` |
-| `private_repository_invitations` | Private repository invitations | `read` |
-| `profile` | Profile | `write` |
-| `git_signing_ssh_public_keys` | SSH signing keys | `read`, `write` |
-| `starring` | Starring | `read`, `write` |
-| `watching` | Watching | `read`, `write` |
-
-{% ifversion copilot %}
-
-> [!NOTE]
-> The `copilot_requests` permission enables making {% data variables.product.prodname_copilot_short %} requests for the given user, which count towards the user's premium request allowance or are charged to overage billing if the allowance is exceeded. For more information about {% data variables.product.prodname_copilot_short %} requests and billing, see [AUTOTITLE](/copilot/concepts/billing/copilot-requests).
-
-{% endif %}
-##### Repository Permissions
-
-Repository permissions work for both user and organization resource owners.
-
-| Parameter name | Display name  | Access levels |
-|---|---|---|
-| `actions` | Actions | `read`, `write` |
-| `administration` | Administration | `read`, `write` |
-| {% ifversion artifact-metadata %} |
-| `artifact_metadata` | Artifact Metadata | `read`, `write` |
-| {% endif %} |
-| `attestations` | Attestations | `read`, `write` |
-| {% ifversion code-quality %} |
-| `code_quality` | Code quality | `read`, `write` |
-| {% endif %} |
-| `security_events` | Code scanning alerts | `read`, `write` |
-| `codespaces` | Codespaces | `read`, `write` |
-| `codespaces_lifecycle_admin` | Codespaces lifecycle admin | `read`, `write` |
-| `codespaces_metadata` | Codespaces metadata | `read` |
-| `codespaces_secrets` | Codespaces secrets | `write` |
-| `statuses` | Commit statuses | `read`, `write` |
-| `contents` | Contents | `read`, `write` |
-| `repository_custom_properties` | Custom properties | `read`, `write` |
-| `vulnerability_alerts` | Dependabot alerts | `read`, `write` |
-| `dependabot_secrets` | Dependabot secrets | `read`, `write` |
-| `deployments` | Deployments | `read`, `write` |
-| `discussions` | Discussions | `read`, `write` |
-| `environments` | Environments | `read`, `write` |
-| `issues` | Issues | `read`, `write` |
-| `merge_queues` | Merge queues | `read`, `write` |
-| `metadata` | Metadata | `read` |
-| `pages` | Pages | `read`, `write` |
-| `pull_requests` | Pull requests | `read`, `write` |
-| `repository_advisories` | Repository security advisories | `read`, `write` |
-| `secret_scanning_alerts` | Secret scanning alerts | `read`, `write` |
-| `secrets` | Secrets | `read`, `write` |
-| `actions_variables` | Variables | `read`, `write` |
-| `repository_hooks` | Webhooks | `read`, `write` |
-| `workflows` | Workflows | `write` |
-
-##### Organization Permissions
-
-Organization permissions can only be used if the resource owner is an organization.
-
-| Parameter name | Display name  | Access levels |
-|---|---|---|
-| `organization_api_insights` | API Insights | `read` |
-| `organization_administration` | Administration | `read`, `write` |
-| `organization_user_blocking` | Blocking users | `read`, `write` |
-| `organization_campaigns` | Campaigns | `read`, `write` |
-| `organization_custom_org_roles` | Custom organization roles | `read`, `write` |
-| `organization_custom_properties` | Custom repository properties | `read`, `write`, `admin` |
-| `organization_custom_roles` | Custom repository roles | `read`, `write` |
-| `organization_events` | Events | `read` |
-| `organization_copilot_seat_management` | GitHub Copilot Business | `read`, `write` |
-| `issue_types` | Issue Types | `read`, `write` |
-| `organization_knowledge_bases` | Knowledge bases | `read`, `write` |
-| `members` | Members | `read`, `write` |
-| `organization_models` | Models | `read` |
-| `organization_network_configurations` | Network configurations | `read`, `write` |
-| `organization_announcement_banners` | Organization announcement banners | `read`, `write` |
-| `organization_codespaces` | Organization codespaces | `read`, `write` |
-| `organization_codespaces_secrets` | Organization codespaces secrets | `read`, `write` |
-| `organization_codespaces_settings` | Organization codespaces settings | `read`, `write` |
-| `organization_dependabot_secrets` | Organization dependabot secrets | `read`, `write` |
-| `organization_code_scanning_dismissal_requests` | Code scanning dismissal requests | `read`, `write` |
-| `organization_private_registries` | Private registries | `read`, `write` |
-| `organization_plan` | Plan | `read` |
-| `organization_projects` | Projects | `read`, `write`, `admin` |
-| `organization_secrets` | Secrets | `read`, `write` |
-| `organization_self_hosted_runners` | Self-hosted runners | `read`, `write` |
-| `team_discussions` | Team discussions | `read`, `write` |
-| `organization_actions_variables` | Variables | `read`, `write` |
-| `organization_hooks` | Webhooks | `read`, `write` |
-
 ## Creating a {% data variables.product.pat_v1 %}
 
 > [!NOTE]

assets/images/help/copilot/copilot-sdk/bundled-cli-authentication-strategies.png

@@ -0,0 +1,30 @@
+---
+title: Get started content type
+intro: Get started content provides the minimal essential information to use a product or feature.
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '*'
+category:
+  - Follow the style guide and content model
+---
+
+Get started content provides an entry point into using GitHub products and features. This section should contain only the minimum essential information a user needs before they move on to concepts and how-tos. We do this to be concise, and also so it doesn't seem complicated just to get started with a feature. 
+
+## Get started considerations
+
+Get started is a set of articles which should be easy and fast to scan. It should contain fewer than 5 articles, and ideally only two:  
+* Quickstart 
+* About [PRODUCT] (or “What is [PRODUCT]”) 
+
+The one exception to this may be with available plans and billing information, where such information is required to use the product or feature. 
+
+For more information on quickstart content, see [AUTOTITLE](/contributing/style-guide-and-content-model/quickstart-content-type). 
+
+In particular, articles with this information do not belong in Get started: 
+ * Articles that fall under the how-to content type. 
+ * Set up or sign up steps: these are also how-tos. They document how to do something in the UI.
+ * Content that is useful for getting started with a particular feature but not the whole product area. This kind of content more properly belongs in Concepts. 
+ * Best practices, generally. Users new to a feature lack the context necessary to make the most of these. 
+
+