From c48a15078a6fc569d9f891f100d3138f41202c0e Mon Sep 17 00:00:00 2001 From: Sophie <29382425+sophietheking@users.noreply.github.com> Date: Mon, 25 Nov 2024 15:11:28 +0100 Subject: [PATCH] Builders: Make Copilot discoverable in Core Productivity docs (#53086) Co-authored-by: Siara <108543037+SiaraMist@users.noreply.github.com> Co-authored-by: hubwriter --- .../help/copilot/copilot-icon-top-right.png | Bin 0 -> 16061 bytes .../contributing-to-a-project.md | 20 +++++--- .../exploring-projects-on-github/index.md | 1 + ...sing-github-copilot-to-explore-projects.md | 45 ++++++++++++++++++ .../using-github/communicating-on-github.md | 38 +++++++++++++-- ...-tracking-work-for-your-team-or-project.md | 35 ++++++++++++++ ...wing-proposed-changes-in-a-pull-request.md | 29 ++++++++++- .../working-with-files/using-files/index.md | 3 +- ....md => viewing-and-understanding-files.md} | 22 +++++++-- .../using-github-code-search.md | 28 +++++++++++ .../copilot/chat-about-specific-lines.md | 31 ++++++++++++ .../copilot/copilot-requires-subscription.md | 1 + 12 files changed, 235 insertions(+), 18 deletions(-) create mode 100644 assets/images/help/copilot/copilot-icon-top-right.png create mode 100644 content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md rename content/repositories/working-with-files/using-files/{viewing-a-file.md => viewing-and-understanding-files.md} (85%) create mode 100644 data/reusables/copilot/chat-about-specific-lines.md create mode 100644 data/reusables/copilot/copilot-requires-subscription.md diff --git a/assets/images/help/copilot/copilot-icon-top-right.png b/assets/images/help/copilot/copilot-icon-top-right.png new file mode 100644 index 0000000000000000000000000000000000000000..24f3f193ae58ed294338fb41cb428eb122235f9b GIT binary patch literal 16061 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 OfTXCLNTHCf_x}Oz@J4C? literal 0 HcmV?d00001 diff --git a/content/get-started/exploring-projects-on-github/contributing-to-a-project.md b/content/get-started/exploring-projects-on-github/contributing-to-a-project.md index a56b9cb68003..4cead07e91c2 100644 --- a/content/get-started/exploring-projects-on-github/contributing-to-a-project.md +++ b/content/get-started/exploring-projects-on-github/contributing-to-a-project.md @@ -18,13 +18,13 @@ redirect_from: ## About forking -If you want to contribute to someone else's project but don't have write access to the repository, you can use a "fork and pull request" workflow. +If you want to contribute to someone else's project but don’t have permission to make changes directly, you can create your own copy of the project, make updates, and then suggest those updates for inclusion in the main project. This process is often called a "fork and pull request" workflow. -{% data reusables.repositories.fork-definition-long %} +When you create your own copy (or "fork") of a project, it’s like making a new workspace that shares code with the original project. This is useful for open-source projects or anytime you don’t have write access to the original project. -You can contribute by submitting pull requests from your fork to the upstream repository. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)." +Once you’ve made your changes in your copy, you can submit them as a pull request, which is a way to propose changes back to the main project. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)." -## Forking a repository +## Creating your own copy of a project This tutorial uses [the Spoon-Knife project](https://github.com/octocat/Spoon-Knife), a test repository that's hosted on {% data variables.product.prodname_dotcom %} that lets you test the fork and pull request workflow. @@ -44,7 +44,7 @@ This tutorial uses [the Spoon-Knife project](https://github.com/octocat/Spoon-Kn > [!NOTE] > If you want to copy additional branches from the upstream repository, you can do so from the **Branches** page. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)." -## Cloning a fork +## Cloning a fork to your computer You've successfully forked the Spoon-Knife repository, but so far, it only exists on {% data variables.product.product_name %}. To be able to work on the project, you will need to clone it to your computer. @@ -99,7 +99,7 @@ gh repo fork REPOSITORY --clone=true ## Creating a branch to work on -Before making changes to the project, you should create a new branch and check it out. By keeping changes in their own branch, you follow GitHub Flow and ensure that it will be easier to contribute to the same project again in the future. For more information, see "[AUTOTITLE](/get-started/using-github/github-flow#following-github-flow)." +Before making changes to the project, you should create a new branch and check it out. By keeping changes in their own branch, you follow {% data variables.product.github %} flow and ensure that it will be easier to contribute to the same project again in the future. See "[AUTOTITLE](/get-started/using-github/github-flow#following-github-flow)." {% webui %} @@ -127,7 +127,7 @@ For more information about how to create and manage branches in {% data variable ## Making and pushing changes -Go ahead and make a few changes to the project using your favorite text editor, like [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com). You could, for example, change the text in `index.html` to add your GitHub username. +Go ahead and make a few changes to the project using your favorite text editor, like [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com). You could, for example, change the text in `index.html` to add your {% data variables.product.github %} username. When you're ready to submit your changes, stage and commit your changes. `git add .` tells Git that you want to include all of your changes in the next commit. `git commit` takes a snapshot of those changes. @@ -199,3 +199,9 @@ Pull requests are an area for discussion. Don't be offended if the project owner You've successfully forked and contributed back to a repository. Go forth, and contribute some more!{% ifversion fpt %} For more information, see "[AUTOTITLE](/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} + +{% ifversion copilot %} + +## Familiarizing yourself with a project + +If you're new to a project, you can use {% data variables.product.prodname_copilot_short %} to help you understand the purpose of the repository, examine files, and dive into specific lines of code. See "[AUTOTITLE](/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects)."{% endif %} diff --git a/content/get-started/exploring-projects-on-github/index.md b/content/get-started/exploring-projects-on-github/index.md index aa32d323f90a..4589eb3fd40a 100644 --- a/content/get-started/exploring-projects-on-github/index.md +++ b/content/get-started/exploring-projects-on-github/index.md @@ -15,6 +15,7 @@ topics: - Projects children: - /finding-ways-to-contribute-to-open-source-on-github + - /using-github-copilot-to-explore-projects - /contributing-to-a-project - /saving-repositories-with-stars - /following-people diff --git a/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md b/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md new file mode 100644 index 000000000000..ac3837d15968 --- /dev/null +++ b/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md @@ -0,0 +1,45 @@ +--- +title: Using GitHub Copilot to explore projects +intro: 'This guide will help you use {% data variables.product.prodname_copilot_short %} to explore projects on {% data variables.product.prodname_dotcom %}.' +versions: + feature: copilot +topics: + - Copilot + - Repositories +shortTitle: Use Copilot to explore projects +--- + +> [!NOTE] {% data variables.product.prodname_copilot_chat_dotcom %} is currently in {% data variables.release-phases.public_preview %} and is subject to change. + +In this guide, you’ll learn how to use {% data variables.product.prodname_copilot_chat_dotcom_short %} to understand a repository’s purpose, examine files, and dive into specific lines of code. By following these steps, you’ll gain insights into any project faster—making onboarding, code review, and project exploration easier and more efficient. + +## Prerequisites + +{% data reusables.copilot.copilot-requires-subscription %} + +## Understanding a repository + +When you’re new to a project, it can be challenging to understand the purpose of a repository and its files. {% data variables.product.prodname_copilot_short %} can help you quickly understand the purpose of a repository, for example, by providing a summary of the repository’s README file. + +1. On the {% data variables.product.prodname_dotcom %} website, go to the repository you want to chat about. + +1. Click the **{% octicon "copilot" aria-hidden="true" %}** {% data variables.product.prodname_copilot %} icon at the top right of the page. +1. The heading at the top of the chat panel should read "Chatting about" followed by the name of the current repository. + + If the wrong repository name is displayed, because you were previously chatting about another repository, click **All repositories** then choose the repository you want to chat about. + + ![Screenshot of the {% data variables.product.prodname_copilot_short %} chat panel page with "All repositories" highlighted with a dark orange outline.](/assets/images/help/copilot/copilot-chat-all-repositories.png) + +1. In the "Ask {% data variables.product.prodname_copilot_short %}" box, at the bottom of the chat panel, type "Summarize the purpose of this repository based on the README" and press Enter. {% data variables.product.prodname_copilot_short %} replies in the chat panel. + +You can also use {% data variables.product.prodname_copilot_short %} to understand the roles of different folders and files within the repository. For example, you can ask {% data variables.product.prodname_copilot_short %} to summarize the contents of a specific file, or to explain the purpose of a specific folder. + +## Exploring files and code + +When you’re exploring a project, you might want to understand the contents of a specific file. {% data variables.product.prodname_copilot_short %} can help you quickly understand the purpose of a file, for example, by providing a summary of the file’s contents. You can also ask {% data variables.product.prodname_copilot_short %} to explain specific lines of code within a file. + +{% data reusables.copilot.chat-about-specific-lines %} + +## Next steps + +Now that you know how to use {% data variables.product.prodname_copilot_short %} to explore projects, you can use it to help you understand any repository, file, or line of code on {% data variables.product.prodname_dotcom %}. diff --git a/content/get-started/using-github/communicating-on-github.md b/content/get-started/using-github/communicating-on-github.md index ac26e9d4e5ba..c544d300e650 100644 --- a/content/get-started/using-github/communicating-on-github.md +++ b/content/get-started/using-github/communicating-on-github.md @@ -59,11 +59,11 @@ You can create and participate in issues, pull requests and team discussions, de ### Team discussions -* can be started on your team's page for conversations that span across projects and don't belong in a specific issue or pull request. Instead of opening an issue in a repository to discuss an idea, you can include the entire team by having a conversation in a team discussion. -* allow you to hold discussions with your team about planning, analysis, design, user research and general project decision making in one place.{% ifversion ghes %} -* provide a collaborative experience outside the codebase, allowing the brainstorming of ideas. -* often don’t have a clear owner. -* often do not result in an actionable task.{% endif %} +* Can be started on your team's page for conversations that span across projects and don't belong in a specific issue or pull request. Instead of opening an issue in a repository to discuss an idea, you can include the entire team by having a conversation in a team discussion. +* Allow you to hold discussions with your team about planning, analysis, design, user research and general project decision making in one place.{% ifversion ghes %} +* Provide a collaborative experience outside the codebase, allowing the brainstorming of ideas. +* Often don’t have a clear owner. +* Often do not result in an actionable task.{% endif %} {% endif %} ## Which discussion tool should I use? @@ -148,6 +148,34 @@ The `octocat` team member posted a team discussion, informing the team of variou * Material about the April All Hands is now available for all team members to view. {% endif %} +{% ifversion copilot %} + +## Using {% data variables.product.prodname_copilot_short %} to gain context + +> [!NOTE] {% data reusables.copilot.copilot-requires-subscription %} + +If you need more context or clarity on a specific issue or discussion, you can use {% data variables.product.prodname_copilot %} to help answer your questions. This enables you to quickly gain insights, understand complex threads, and stay aligned with the project’s goals, fostering collaboration and knowledge sharing within the community. + +To ask a question about an issue or discussion: + +1. From anywhere on {% data variables.product.github %}, click the **{% octicon "copilot" aria-hidden="true" %}** {% data variables.product.prodname_copilot %} icon next to the search bar in the top right of the page. + + ![Screenshot of the new conversation button, highlighted with a dark orange outline.](/assets/images/help/copilot/copilot-icon-top-right.png) + +1. In the "Ask {% data variables.product.prodname_copilot_short %}" box, type a question and include the relevant URL in your message. For example, you could ask: + + * `Explain https://github.com/monalisa/octokit/issues/1` + * `Summarize https://github.com/monalisa/octokit/discussions/4` + * `Recommend next steps for https://github.com/monalisa/octokit/issues/2` + * `What are the acceptance criteria for ISSUE URL?` + * `What are the main points made by PERSON in DISCUSSION URL?` + + If you chat with {% data variables.product.prodname_copilot %} from a specific issue or discussion, you don't need to include the URL in your question. + +{% data reusables.copilot.stop-response-generation %} + +{% endif %} + ## Next steps These examples showed you how to decide which is the best tool for your conversations on {% data variables.product.product_name %}. But this is only the beginning; there is so much more you can do to tailor these tools to your needs. diff --git a/content/issues/tracking-your-work-with-issues/configuring-issues/planning-and-tracking-work-for-your-team-or-project.md b/content/issues/tracking-your-work-with-issues/configuring-issues/planning-and-tracking-work-for-your-team-or-project.md index 5e504821894f..7b5c09338124 100644 --- a/content/issues/tracking-your-work-with-issues/configuring-issues/planning-and-tracking-work-for-your-team-or-project.md +++ b/content/issues/tracking-your-work-with-issues/configuring-issues/planning-and-tracking-work-for-your-team-or-project.md @@ -94,6 +94,41 @@ Below we have added a task list to our Project Octocat issue, breaking it down i {% endif %} +{% ifversion copilot %} + +## Understanding new issues + +> [!NOTE] {% data reusables.copilot.copilot-requires-subscription %} + +When working on an unfamiliar or complex issue, {% data variables.product.prodname_copilot %} can help you quickly understand the context, history, and key information, so you can get started faster and with more confidence. + +### Reviewing the issue + +1. Navigate to an issue on {% data variables.product.github %}. + +{% data reusables.copilot.open-copilot %} + +1. At the bottom of the {% data variables.product.prodname_copilot_short %} chat panel, in the "Ask {% data variables.product.prodname_copilot_short %}" box, type a question and press Enter. For example, you could enter: + + * `Summarize the main points of this issue` + * `What’s the goal of this issue?` + +{% data variables.product.prodname_copilot_short %}'s summary will help you capture the purpose and scope of the work. + +### Understanding the history and comments + +Issues often contain a history of discussions and decisions that can provide important context. You can use {% data variables.product.prodname_copilot_short %} to summarize these conversations to identify key points, such as proposed solutions or unanswered questions. For example, you might ask {% data variables.product.prodname_copilot_short %} to summarize recent comments or highlight decisions that have already been made. This helps you focus on what’s most relevant and ensures your contributions are aligned with the team’s priorities. + +### Clarifying technical terms + +Issues often mention technical terms, code, or files that might not be immediately clear. You can use {% data variables.product.prodname_copilot_short %} to get explanations or context for these references. For example, you can ask about the purpose of a file or function, or the meaning of a specific term mentioned in the issue. This helps you understand the details without spending extra time searching through documentation or code. + +### Getting suggestions for next steps + +Once you understand the context of an issue, {% data variables.product.prodname_copilot_short %} can help you figure out how to move forward. You can ask for suggestions on how to approach the work, like fixing a bug or implementing a new feature. For example, you might ask, “What’s the best way to resolve this issue?” or “How can I start addressing this problem?” {% data variables.product.prodname_copilot_short %}'s suggestions can provide useful starting points, helping you plan your work more effectively. + +{% endif %} + ## Making decisions as a team You can use issues and discussions to communicate and make decisions as a team on planned improvements or priorities for your project. Issues are useful when you create them for discussion of specific details, such as bug or performance reports, planning for the next quarter, or design for a new initiative. Discussions are useful for open-ended brainstorming or feedback, outside the codebase and across repositories. For more information, see "[AUTOTITLE](/get-started/using-github/communicating-on-github#which-discussion-tool-should-i-use)." diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 6f7105920c02..78b27aef69de 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -56,7 +56,7 @@ Before you submit your review, your line comments are _pending_ and only visible You can use [{% data variables.product.prodname_github_codespaces %}](/codespaces/overview) to test, run, and review pull requests. 1. Open the pull request in a codespace, as described in "[AUTOTITLE](/codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests#opening-a-pull-request-in-codespaces)." -1. In the Activity Bar, click the **GitHub Pull Request** view. This view only appears when you open a pull request in a codespace. +1. In the Activity Bar, click the **{% data variables.product.github %} Pull Request** view. This view only appears when you open a pull request in a codespace. ![Screenshot of the {% data variables.product.prodname_vscode_shortname %} Activity Bar. The mouse pointer is hovering over an icon displaying the tooltip "{% data variables.product.prodname_dotcom %} Pull Request."](/assets/images/help/codespaces/github-pr-view.png) @@ -79,6 +79,33 @@ For more information on reviewing pull requests in {% data variables.product.pro {% endcodespaces %} {% endif %} +{% webui %} +{% ifversion copilot %} + +## Understanding changes in a pull request + +> [!NOTE] {% data reusables.copilot.copilot-requires-subscription %} + +{% data variables.product.prodname_copilot %} can help you quickly understand the changes in a pull request by providing context and explanations for specific commits. If you’re unsure about the purpose of a particular change or need more details about how it fits into the broader codebase, you can ask {% data variables.product.prodname_copilot_short %} questions about individual commits. + +1. Navigate to a commit on {% data variables.product.github %}. + +{% data reusables.copilot.open-copilot %} + +1. At the bottom of the {% data variables.product.prodname_copilot_short %} chat panel, in the "Ask {% data variables.product.prodname_copilot_short %}" box, type a question and press Enter. For example, you could enter: + + * `Summarize the changes in this commit` + * `Who committed these changes?` + * `When was this commit made?` + + > [!TIP] + > If you know the SHA for a commit, instead of navigating to the commit, you can ask {% data variables.product.prodname_copilot_short %} about the commit from any page in the repository on {% data variables.product.github %} by including the SHA in your message. For example, `What changed in commit a778e0eab?` + +{% data reusables.copilot.stop-response-generation %} + +{% endif %} +{% endwebui %} + ## Reviewing dependency changes If the pull request contains changes to dependencies you can use the dependency review for a manifest or lock file to see what has changed and check whether the changes introduce security vulnerabilities. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)." diff --git a/content/repositories/working-with-files/using-files/index.md b/content/repositories/working-with-files/using-files/index.md index 25a13d198a9b..0d1726ad2cbe 100644 --- a/content/repositories/working-with-files/using-files/index.md +++ b/content/repositories/working-with-files/using-files/index.md @@ -7,9 +7,8 @@ versions: ghec: '*' children: - /navigating-code-on-github - - /viewing-a-file + - /viewing-and-understanding-files - /getting-permanent-links-to-files - /downloading-source-code-archives - /working-with-non-code-files --- - diff --git a/content/repositories/working-with-files/using-files/viewing-a-file.md b/content/repositories/working-with-files/using-files/viewing-and-understanding-files.md similarity index 85% rename from content/repositories/working-with-files/using-files/viewing-a-file.md rename to content/repositories/working-with-files/using-files/viewing-and-understanding-files.md index d3444096d2ac..0d979f409e4f 100644 --- a/content/repositories/working-with-files/using-files/viewing-a-file.md +++ b/content/repositories/working-with-files/using-files/viewing-and-understanding-files.md @@ -1,6 +1,6 @@ --- -title: Viewing a file -intro: You can view raw file content or trace changes to lines in a file and discover how parts of the file evolved over time. +title: Viewing and understanding files +intro: Explore file content and trace changes over time to understand a new codebase and its evolution. redirect_from: - /articles/using-git-blame-to-trace-changes-in-a-file - /articles/tracing-changes-in-a-file @@ -8,14 +8,18 @@ redirect_from: - /github/managing-files-in-a-repository/tracking-changes-in-a-file - /github/managing-files-in-a-repository/managing-files-on-github/tracking-changes-in-a-file - /repositories/working-with-files/using-files/tracking-changes-in-a-file + - /repositories/working-with-files/using-files/viewing-a-file versions: fpt: '*' ghes: '*' ghec: '*' topics: - Repositories -shortTitle: View files and track file changes +shortTitle: View and understand files --- + +{% data variables.product.github %} provides tools to view raw content, trace changes to specific lines, and explore how a file’s content has evolved over time. These insights reveal how code was developed, its current purpose, and its structure, helping you contribute effectively. + ## Viewing or copying the raw file content With the raw view, you can view or copy the raw content of a file without any styling. @@ -100,3 +104,15 @@ git config blame.ignoreRevsFile .git-blame-ignore-revs ## Bypassing `.git-blame-ignore-revs` in the blame view If the blame view for a file shows **Ignoring revisions in .git-blame-ignore-revs**, you can still bypass `.git-blame-ignore-revs` and see the normal blame view. In the URL, append a `~` to the SHA and the **Ignoring revisions in .git-blame-ignore-revs** banner will disappear. + +{% ifversion copilot %} + +## Understanding files with {% data variables.product.prodname_copilot_short %} + +> [!NOTE] {% data reusables.copilot.copilot-requires-subscription %} + +You can also use {% data variables.product.prodname_copilot_short %} to ask about specific lines of code in a file, helping you understand how the code works and reducing the risk of introducing new problems. + +{% data reusables.copilot.chat-about-specific-lines %} + +{% endif %} diff --git a/content/search-github/github-code-search/using-github-code-search.md b/content/search-github/github-code-search/using-github-code-search.md index 8fb796838f01..2a635b716908 100644 --- a/content/search-github/github-code-search/using-github-code-search.md +++ b/content/search-github/github-code-search/using-github-code-search.md @@ -37,6 +37,34 @@ For more information about the search syntax of code search, see "[AUTOTITLE](/s 1. After typing your query, you can also press Enter to go to the full search results view, where you can see each match and a visual interface for applying filters. For more information, see "[Using the search results view](#using-the-search-results-view)." +{% ifversion copilot %} + +## Getting answers with {% data variables.product.prodname_copilot_short %} from the search bar + +> [!NOTE] {% data reusables.copilot.copilot-requires-subscription %} + +You can use {% data variables.product.prodname_copilot %} to ask questions about an entire repository directly from the main search box. Simply type your question into the search bar, and {% data variables.product.prodname_copilot_short %} can provide insights or explanations about the repository’s structure, purpose, or specific components. This makes it easy to get quick answers without navigating through multiple files, helping you stay focused and maintain your workflow. + +1. Navigate to a repository on {% data variables.product.github %}. +1. Press /, or click in the main search box at the top of the page. +1. In the search box, after `repo:OWNER/REPO`, type the question you want to ask {% data variables.product.prodname_copilot_short %}. + + For example, you could enter: + + * `What does this repo do?` + * `Where is authentication implemented in this codebase?` + * `How does license file detection work in this repo?` + +1. Click **Ask {% data variables.product.prodname_copilot_short %}**. + + ![Screenshot of the main search box on {% data variables.product.prodname_dotcom %}. The drop-down option "Ask {% data variables.product.prodname_copilot_short %}" is highlighted with an orange outline.](/assets/images/help/copilot/ask-copilot-from-search-bar.png) + + The {% data variables.product.prodname_copilot_chat %} panel is displayed and {% data variables.product.prodname_copilot_short %} responds to your request. + +{% data reusables.copilot.stop-response-generation %} + +{% endif %} + ## Creating and managing saved searches 1. In the top navigation of {% data variables.product.prodname_dotcom %}, click the search bar and type `saved:`. diff --git a/data/reusables/copilot/chat-about-specific-lines.md b/data/reusables/copilot/chat-about-specific-lines.md new file mode 100644 index 000000000000..56e0e5d16bad --- /dev/null +++ b/data/reusables/copilot/chat-about-specific-lines.md @@ -0,0 +1,31 @@ +1. On {% data variables.product.github %}, navigate to a repository and open a file. +1. Do one of the following: + * To ask a question about the **entire file**, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" %}) at the top right of the file view. + + ![Screenshot of the {% data variables.product.prodname_copilot_short %} button, highlighted with a dark orange outline, at the top of the file view.](/assets/images/help/copilot/copilot-button-for-file.png) + + * To ask a question about **specific lines** within the file: + + 1. Click the line number for the first line you want to ask about, hold down Shift, then click the line number for the last line you want to select. + 1. To ask your own question about the selected lines, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" %}) to the right of your selection, then type your question in the {% data variables.product.prodname_copilot_chat %} panel. + 1. To ask a predefined question, click the drop-down menu beside the {% data variables.product.prodname_copilot_short %} icon, then choose one of the options. + + ![Screenshot of the {% data variables.product.prodname_copilot_short %} buttons, highlighted with a dark orange outline, to the right of some selected code.](/assets/images/help/copilot/copilot-buttons-inline-code.png) + +1. If you clicked the {% data variables.product.prodname_copilot_short %} icon, type a question in the "Ask {% data variables.product.prodname_copilot_short %}" box at the bottom of the chat panel and press Enter. + + For example, if you are asking about the entire file, you could enter: + * `Explain this file.` + * `How could I improve this code?` + * `How can I test this script?` + + If you are asking about specific lines, you could enter: + * `Explain the function at the selected lines.` + * `How could I improve this class?` + * `Add error handling to this code.` + * `Write a unit test for this method.` + + {% data variables.product.prodname_copilot_short %} responds to your request in the panel. + +{% data reusables.copilot.stop-response-generation %} +1. You can continue the conversation by asking a follow-up question. For example, you could type "tell me more" to get {% data variables.product.prodname_copilot_short %} to expand on its last comment. diff --git a/data/reusables/copilot/copilot-requires-subscription.md b/data/reusables/copilot/copilot-requires-subscription.md new file mode 100644 index 000000000000..45d899e05d41 --- /dev/null +++ b/data/reusables/copilot/copilot-requires-subscription.md @@ -0,0 +1 @@ +You'll need a {% data variables.product.prodname_copilot %} subscription. For more information, see "[AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot)."