Skip to content

Commit

Permalink
Merge pull request github#34081 from github/repo-sync
Browse files Browse the repository at this point in the history
Repo sync
  • Loading branch information
docs-bot authored Jul 24, 2024
2 parents ba5bd75 + e630fbd commit 5d7ba42
Show file tree
Hide file tree
Showing 13 changed files with 891 additions and 16 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,10 @@ A chat-like interface in the terminal, where you can ask questions about the com

AI-generated summaries of the changes that were made in a pull request, which files they impact, and what a reviewer should focus on when they conduct their review.

### {% data variables.product.prodname_copilot_autocomplete_pr %} (beta) _({% data variables.product.prodname_copilot_enterprise_short %} only)_

AI-generated text completion to help you write pull request descriptions quickly and accurately.

### {% data variables.product.prodname_copilot_short %} knowledge bases _({% data variables.product.prodname_copilot_enterprise_short %} only)_

Create and manage collections of documentation to use as context for chatting with {% data variables.product.prodname_copilot_short %}. When you ask a question in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_dotcom_the_website %} or in {% data variables.product.prodname_vscode_shortname %}, you can specify a knowledge base as the context for your question.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,9 @@ With a {% data variables.product.prodname_copilot_enterprise_short %} license, y

If you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}", you can also configure additional features:
* **Opt in to user feedback collection** - If enabled, members of your enterprise can provide feedback after {% data variables.product.prodname_copilot_short %} generates a pull request summary, and the summary will be sent to {% data variables.product.prodname_dotcom %} for context. If disabled, members of your enterprise can still provide feedback after each {% data variables.product.prodname_copilot_chat_short %} response, and via the "Give feedback" link in conversations.
* **Previews of {% data variables.product.prodname_copilot_short %} features** - If enabled, members of your enterprise can test new {% data variables.product.prodname_copilot_short %} features that are not yet generally available. Be aware that previews of features may have flaws, and the features may be changed or discontinued at any time. Current previews of {% data variables.product.prodname_copilot_short %} features:

* {% data variables.product.prodname_copilot_autocomplete_pr %}. For more information, see "[Using Copilot text completion](/copilot/using-github-copilot/using-copilot-text-completion)."

### {% data variables.product.prodname_copilot_cli %}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,5 @@ children:
- /responsible-use-of-github-copilot-chat-in-github-mobile
- /responsible-use-of-github-copilot-in-the-cli
- /responsible-use-of-github-copilot-pull-request-summaries
- /responsible-use-of-github-copilot-text-completion
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: Responsible use of GitHub Copilot text completion
shortTitle: Copilot text completion
intro: 'Learn how to use {% data variables.product.prodname_copilot_autocomplete_pr %} responsibly by understanding its purposes, capabilities, and limitations.'
versions:
feature: copilot
permissions: 'Members of an enterprise with a subscription to {% data variables.product.prodname_copilot_enterprise %}'
topics:
- Copilot
type: rai
---

{% ifversion fpt %}

{% data reusables.rai.copilot.enterprise-fpt-link %}

{% endif %}

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

{% data variables.product.prodname_copilot_autocomplete_pr %} is an AI-powered feature that allows users to more easily write pull request descriptions by suggesting text as you type.

When you pause briefly while typing a summary, {% data variables.product.prodname_copilot_short %} scans through the pull request and provides suggested prose, attempting to finish your thought.

The only supported language for {% data variables.product.prodname_copilot_autocomplete_pr %} is English.

{% data variables.product.prodname_copilot_autocomplete_pr %} uses a simple-prompt flow leveraging the {% data variables.product.prodname_copilot_short %} API, utilizing the generic large language model, with no additional trained models.

When you pause during typing the pull request description, a call is generated to the {% data variables.product.prodname_copilot_short %} API to generate suggested text to insert into the description at the current cursor position. The text complete request includes information from the pull request, including the pull request title, any text already in the description, the pull request commit titles, partial raw diffs, and recently viewed pull request and issue titles in a prompt that requests {% data variables.product.prodname_copilot_short %} to generate a suggestion for the next words you are likely to type. The response is then displayed as grayed out text following the cursor. You can accept the suggested text by pressing the tab key, or reject the suggestion by simply continuing to type, or moving the cursor focus out of the description field.

## Use case for pull request text complete

The goal of {% data variables.product.prodname_copilot_autocomplete_pr %} is to help the pull request author to quickly provide context to the human reviewers of the pull request. When reviewing a pull request it is valuable to understand context such as why changes are being requested and how the pull request makes those changes. It may help increase developer productivity by reducing the time taken to open a pull request.

## Improving the performance of pull request text complete

The feature is intended to supplement rather than replace a human's work adding context to pull requests. The quality of the text complete suggestions will depend on the quality of the title, the commit messages, and the text already added to the description. We encourage you to continue adding useful context and let {% data variables.product.prodname_copilot_short %} suggest as you go. It remains your responsibility to review and assess the accuracy of information in the pull requests you create.

## Limitations of pull request text complete

Currently, our team is aware that there are limitations to this feature. Many of them are expected in leveraging our {% data variables.product.prodname_copilot_short %} API; however, there are a few that are specific to {% data variables.product.prodname_copilot_autocomplete_pr %} which pertain to limited scope for very large pull requests, and potentially inaccurate responses. We also note that users should expect terms used in their pull request to appear in the AI-generated suggestions.

This feature has been subject to RAI Red Teaming and we will continue to monitor the efficacy and safety of the feature over time. For more information, see "[Microsoft AI Red Team building future of safer AI](https://www.microsoft.com/en-us/security/blog/2023/08/07/microsoft-ai-red-team-building-future-of-safer-ai/)" on the Microsoft security blog.

### Limited scope

It is possible for very large pull requests, that some of the pull request content that the {% data variables.product.prodname_copilot_short %} API relies upon for automatically suggesting text will not fit into the API call, and so for very large pull requests, some of the suggestions you might expect may not occur.

### Inaccurate responses

The more inputs and context that {% data variables.product.prodname_copilot_short %} has to work from, the better the text complete suggestions will be. However, since the feature is quite new, it will take time to reach exact precision with the text complete suggestions that are generated. In the meantime, there may be cases where a generated text complete is less accurate and requires the user to make modifications before saving and publishing their pull request with this description. In addition, there is a risk of "hallucination," where {% data variables.product.prodname_copilot_short %} generates statements that are inaccurate. For these reasons, reviewing is a requirement, and careful review of the output is highly recommended.

### Replication of pull request content

Because a text complete suggestion is drawn from changes that were made in a pull request, if harmful or offensive terms are within the content of the pull request, there is potential for the suggestion to also include those terms.

## Further reading

* [{% data variables.product.prodname_copilot %} Trust Center](https://resources.github.com/copilot-trust-center/)
1 change: 1 addition & 0 deletions content/copilot/using-github-copilot/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ children:
- /asking-github-copilot-questions-in-githubcom
- /asking-github-copilot-questions-in-github-mobile
- /creating-a-pull-request-summary-with-github-copilot
- /using-copilot-text-completion
- /using-github-copilot-in-the-command-line
- /prompt-engineering-for-github-copilot
- /using-extensions-to-integrate-external-tools-with-copilot-chat
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: Using Copilot text completion
shortTitle: Text completion
intro: 'You can use {% data variables.product.prodname_copilot_autocomplete_pr %} to help you write pull request descriptions more quickly and accurately.'
versions:
feature: copilot-enterprise
permissions: 'Members of an enterprise with a subscription to [{% data variables.product.prodname_copilot_enterprise %}](/copilot/github-copilot-enterprise/overview/about-github-copilot-enterprise)'
topics:
- Copilot
---

>[!NOTE]
> {% data variables.product.prodname_copilot_autocomplete_pr %} is currently in beta and subject to change. To participate in the beta, an administrator of your enterprise must opt in to the use of previews of {% data variables.product.prodname_copilot_short %} features.
## About {% data variables.product.prodname_copilot_autocomplete_pr %}

With {% data variables.product.prodname_copilot_autocomplete_pr %}, you can use AI-generated autocompletions to help you write pull request descriptions quickly and accurately. Accurate descriptions help reviewers understand the changes you're proposing, and help you communicate the purpose of your pull request more effectively.

When you are creating a new pull request, {% data variables.product.prodname_copilot_autocomplete_pr %} will scan through the pull request and provide suggestions as you write, based on the context of the pull request.

## Using {% data variables.product.prodname_copilot_autocomplete_pr %}

You can use {% data variables.product.prodname_copilot_autocomplete_pr %} in the description of a new pull request you're creating.

1. On {% data variables.product.prodname_dotcom_the_website %}, create a pull request.
1. In the description field, start typing your description.
1. As you type, {% data variables.product.prodname_copilot_short %} will provide in-line suggestions based on the context of the pull request.
1. Review the suggestions, which will be shown in grey.
* To accept a suggestion, press `Tab`.
* To ignore a suggestion, press `Esc` or continue typing. {% data variables.product.prodname_copilot_short %} will provide new suggestions as you type, based on the additional context.
1. When you're happy with the description, click **Create pull request**.

## Disabling or enabling {% data variables.product.prodname_copilot_autocomplete_pr %}

You can disable or enable {% data variables.product.prodname_copilot_autocomplete_pr %} for your pull request descriptions. Your preference will be saved for future pull requests.

1. On {% data variables.product.prodname_dotcom_the_website %}, create a pull request.
1. At the top of the description field, select {% octicon "copilot" aria-hidden="true" %} then hover over **Autocomplete (Beta)**, and click **Disabled** or **Enabled**.
4 changes: 4 additions & 0 deletions data/reusables/copilot/copilot-enterprise-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@

{% data variables.product.prodname_copilot_for_prs %} is an AI-powered feature that allows you to create a summary of the changes that were made in a pull request, which files they impact, and what a reviewer should focus on when they conduct their review. For more information, see "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-pull-request-summaries/about-copilot-pull-request-summaries)."

### {% data variables.product.prodname_copilot_autocomplete_pr %} (beta)

{% data variables.product.prodname_copilot_autocomplete_pr %} is a feature that provides AI-generated autocompletions to help you write pull request descriptions quickly and accurately. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/using-copilot-pull-request-autocomplete)."

### {% data variables.product.prodname_copilot_short %} knowledge bases

Knowledge bases are collections of Markdown documentation from one or more repositories. When you ask {% data variables.product.prodname_copilot_chat_short %} a question in {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.prodname_vscode_shortname %}, and {% data variables.product.prodname_vs %} you can specify a knowledge base as the context for your question. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-copilot-knowledge-bases)."
1 change: 1 addition & 0 deletions data/variables/product.yml
Original file line number Diff line number Diff line change
Expand Up @@ -276,6 +276,7 @@ prodname_copilot_for_prs: 'Copilot pull request summaries'
prodname_copilot_prs_short: 'pull request summaries'
prodname_copilot_customization: 'Copilot Customization'
prodname_copilot_in_support: 'Copilot in GitHub Support'
prodname_copilot_autocomplete_pr: 'Copilot text completion'

# Command Palette
prodname_command_palette: 'GitHub Command Palette'
Expand Down
22 changes: 22 additions & 0 deletions src/graphql/data/fpt/changelog.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,26 @@
[
{
"schemaChanges": [
{
"title": "The GraphQL schema includes these changes:",
"changes": [
"<p>Type <code>MergeQueueGroupingStrategy</code> was added</p>",
"<p>Type <code>MergeQueueMergeMethod</code> was added</p>",
"<p>Type <code>MergeQueueParameters</code> was added</p>",
"<p>Type <code>MergeQueueParametersInput</code> was added</p>",
"<p>Field <code>viewerCanLabel</code> was added to object type <code>Discussion</code></p>",
"<p>Field <code>viewerCanLabel</code> was added to object type <code>Issue</code></p>",
"<p>Field <code>viewerCanLabel</code> was added to interface <code>Labelable</code></p>",
"<p>Field <code>viewerCanLabel</code> was added to object type <code>PullRequest</code></p>",
"<p>Member <code>MergeQueueParameters</code> was added to Union type <code>RuleParameters</code></p>",
"<p>Input field <code>mergeQueue</code> of type <code>MergeQueueParametersInput</code> was added to input object type <code>RuleParametersInput</code></p>"
]
}
],
"previewChanges": [],
"upcomingChanges": [],
"date": "2024-07-24"
},
{
"schemaChanges": [
{
Expand Down
Loading

0 comments on commit 5d7ba42

Please sign in to comment.