From 1823fc7f54e35e499a74f12c9eb553a7faec103b Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Wed, 28 Aug 2024 12:32:32 +0200 Subject: [PATCH 1/2] copilot: clarify setup instructions Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- content/copilot/docker-agent-copilot.png | Bin 0 -> 10011 bytes content/copilot/index.md | 37 ++++++++++++++++++++--- 2 files changed, 32 insertions(+), 5 deletions(-) create mode 100644 content/copilot/docker-agent-copilot.png diff --git a/content/copilot/docker-agent-copilot.png b/content/copilot/docker-agent-copilot.png new file mode 100644 index 0000000000000000000000000000000000000000..3e2476f5b28c08db5655f08b5e9e553abee8e7ff GIT binary patch literal 10011 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 literal 0 HcmV?d00001 diff --git a/content/copilot/index.md b/content/copilot/index.md index 3ace7e42fa..0acf5da971 100644 --- a/content/copilot/index.md +++ b/content/copilot/index.md @@ -49,12 +49,33 @@ Here's how to get started with the Docker Extension for GitHub Copilot. Before you start, ensure that: - You have been granted access to GitHub's [limited public beta program](https://github.blog/changelog/2024-05-21-copilot-extensions-now-in-limited-public-beta/). -- The [Docker for GitHub Copilot](https://github.com/marketplace/docker-for-github-copilot) - app is installed in your GitHub organization. +- You're signed in to your GitHub account on GitHub.com. -### Setup +### Install the extension for your organization -Select where you want to use the Docker Extension for GitHub Copilot: +1. Go to the [Docker for GitHub Copilot](https://github.com/marketplace/docker-for-github-copilot) + app in the GitHub Marketplace. + +2. Select the **Add** button at the top of the page. + +3. Under **Pricing and setup**, select the organization that you want to + install the extension for and select **Install it for free**. + +4. Select the **Complete order and begin installation** button. + +5. Select the repositories where you want to use the Docker Extension for + GitHub Copilot and finish with **Install**. + +> [!NOTE] +> Before you can use Copilot Extensions in your organization, you need to +> enable the Copilot Extensions policy. For more information, see +> [Setting a policy for GitHub Copilot Extensions in your organization](https://docs.github.com/en/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#setting-a-policy-for-github-copilot-extensions-in-your-organization). + +### Set up Copilot Chat + +Once you've installed the Docker extension and enabled the Copilot Extensions +policy, you can use the Docker Extension for GitHub Copilot in your editor or +IDE, or on GitHub.com. {{< tabs >}} {{< tab name="Editor or IDE" >}} @@ -76,6 +97,12 @@ see [Using the extension](#using-the-extension). {{< /tab >}} {{< /tabs >}} +You can verify that the extension has been properly installed by typing +`@docker` in the Copilot Chat window. As you type, you should see the Docker +agent appear in the chat interface. + +![Docker agent in chat](/copilot/docker-agent-copilot.png) + ## Using the Extension The Docker Extension for GitHub Copilot provides a chat interface that you can @@ -89,7 +116,7 @@ guidance on Dockerfiles, Docker Compose files, and other Docker assets. 1. Open your project in your editor. 2. Open the Copilot extension or plugin. -3. Interact with the Docker agent using the `/docker` slash prompt, followed by your question. +3. Interact with the Docker agent using the `/docker` or `@docker`, followed by your question. ### GitHub.com From 9b584ff1d2f3e79e340be0b535c40746c72a5ef7 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Wed, 28 Aug 2024 17:34:25 +0200 Subject: [PATCH 2/2] copilot: improve consistency in references to extension Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> --- content/copilot/index.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/content/copilot/index.md b/content/copilot/index.md index 0acf5da971..bccbcc2d34 100644 --- a/content/copilot/index.md +++ b/content/copilot/index.md @@ -6,7 +6,7 @@ keywords: Docker, GitHub Copilot, extension, Visual Studio Code, chat, ai, conta {{% restricted title="Early access" %}} -The Docker for GitHub Copilot extension is a part of the [Limited Public Beta](https://github.blog/changelog/2024-05-21-copilot-extensions-now-in-limited-public-beta/) +The Docker Extension for GitHub Copilot is a part of the [Limited Public Beta](https://github.blog/changelog/2024-05-21-copilot-extensions-now-in-limited-public-beta/) for GitHub Copilot Extensions. To get access, [sign up for the Copilot Extensions waitlist](https://github.com/github-copilot/copilot_extensions_waitlist_signup). @@ -73,9 +73,9 @@ Before you start, ensure that: ### Set up Copilot Chat -Once you've installed the Docker extension and enabled the Copilot Extensions -policy, you can use the Docker Extension for GitHub Copilot in your editor or -IDE, or on GitHub.com. +Once you've installed the Docker Extension for GitHub Copilot and enabled the +Copilot Extensions policy, you can use the extension in your editor or IDE, or +on GitHub.com. {{< tabs >}} {{< tab name="Editor or IDE" >}} @@ -103,7 +103,7 @@ agent appear in the chat interface. ![Docker agent in chat](/copilot/docker-agent-copilot.png) -## Using the Extension +## Using the extension The Docker Extension for GitHub Copilot provides a chat interface that you can use to interact with the Docker agent. You can ask questions and get help @@ -114,13 +114,15 @@ guidance on Dockerfiles, Docker Compose files, and other Docker assets. ### Editor +To use the extension in your editor or IDE: + 1. Open your project in your editor. -2. Open the Copilot extension or plugin. +2. Open the Copilot chat interface. 3. Interact with the Docker agent using the `/docker` or `@docker`, followed by your question. ### GitHub.com -To use the Docker Extension in the GitHub web interface: +To use the extension in the GitHub web interface: 1. Go to [github.com](https://github.com/) and sign in to your account. 2. Go to any repository.