copilot: restructure content, editorial improvements

Signed-off-by: David Karlsson <[email protected]>

Author: dvdksn

content/manuals/copilot/_index.md

@@ -0,0 +1,65 @@
+---
+title: Docker for GitHub Copilot
+params:
+  sidebar:
+    badge:
+      color: violet
+      text: EA
+weight: 100
+description: Learn how to use the Docker for GitHub Copilot extension to streamline Docker-related tasks.
+keywords: Docker, GitHub Copilot, extension, Visual Studio Code, chat, ai, containerization
+---
+
+{{% restricted title="Early Access" %}}
+The Docker for GitHub Copilot extension is an [early access](/release-lifecycle#early-access-ea) product.
+{{% /restricted %}}
+
+The [Docker for GitHub Copilot](https://github.com/marketplace/docker-for-github-copilot)
+extension integrates Docker's capabilities with GitHub Copilot, providing
+assistance with containerizing applications, generating Docker assets, and
+analyzing project vulnerabilities. This extension helps you streamline
+Docker-related tasks wherever GitHub Copilot Chat is available.
+
+## Key features
+
+Key features of the Docker for GitHub Copilot extension include:
+
+- Ask questions and receive responses about containerization in any context
+  where GitHub Copilot Chat is available, such as on GitHub.com and in Visual Studio Code.
+- Automatically generate Dockerfiles, Docker Compose files, and .dockerignore
+  files for a project.
+- Open pull requests with generated Docker assets directly from the chat
+  interface.
+- Get summaries of project vulnerabilities from [Docker
+  Scout](/manuals/scout/_index.md) and receive next steps via CLI.
+
+## Data Privacy
+
+The Docker agent is trained exclusively on Docker's documentation and tools to
+assist with containerization and related tasks. It does not have access to your
+project's data outside the context of the questions you ask.
+
+When using the Docker Extension for GitHub Copilot, GitHub Copilot may include
+a reference to the currently open file in its request if authorized by the
+user. The Docker agent can read the file to provide context-aware responses.
+
+If the agent is requested to check for vulnerabilities or generate
+Docker-related assets, it will clone the referenced repository into in-memory
+storage to perform the necessary actions.
+
+Source code, questions, and responses are not persistently stored. The Docker
+agent processes data only to provide responses and discards it immediately
+afterward.
+
+## Supported languages
+
+The Docker Extension for GitHub Copilot supports the following
+programming languages:
+
+- Dockerfile
+- Go
+- Java
+- JavaScript
+- Python
+- Rust
+- TypeScript

content/manuals/copilot/examples.md

@@ -0,0 +1,47 @@
+---
+title: Example prompts for the Docker agent
+linkTitle: Example prompts
+description: |
+  Discover example prompts to interact with the Docker agent and learn how to
+  automate tasks like Dockerizing projects or opening pull requests.
+weight: 30
+---
+
+{{% restricted title="Early Access" %}}
+The Docker for GitHub Copilot extension is an [early access](/release-lifecycle#early-access-ea) product.
+{{% /restricted %}}
+
+Here are some examples of the types of questions you can ask the Docker agent:
+
+### Ask general Docker questions
+
+You can ask general question about Docker. For example:
+
+- `@docker what is a Dockerfile`
+- `@docker how do I build a Docker image`
+- `@docker how do I run a Docker container`
+
+### Ask questions about your project
+
+You can ask questions about your project, such as:
+
+- `@docker what is the best way to Dockerize this project`
+- `@docker can you help me find vulnerabilities in my project?`
+
+The Docker agent will analyze your project, generate the necessary files, and,
+if applicable, offer to raise a pull request with the necessary Docker assets.
+
+## Performing actions on your behalf
+
+Before the agent performs any actions on your behalf, such as opening a pull
+request for you, you're prompted to provide your consent to allow the
+operation. You can always roll back or back out of the changes.
+
+![Copilot action prompt](images/copilot-action-prompt.png?w=400px)
+
+In the event that the agent encounters an error, for example during PR
+creation, it handles timeouts and lack of responses gracefully.
+
+## Feedback
+
+For issues or feedback, visit the [GitHub feedback repository](https://github.com/docker/copilot-issues).

content/manuals/copilot/copilot-action-prompt.png renamed to content/manuals/copilot/images/copilot-action-prompt.png

@@ -0,0 +1,43 @@
+---
+title: Install the extension for your organization
+linkTitle: Install
+description: |
+  Learn how to install the Docker for GitHub Copilot extension for your
+  organization and manage relevant policies to enable seamless integration.
+weight: 10
+---
+
+{{% restricted title="Early Access" %}}
+The Docker for GitHub Copilot extension is an [early access](/release-lifecycle#early-access-ea) product.
+{{% /restricted %}}
+
+To use the Docker for GitHub copilot extension, you first need to
+[install](#install) the extension for your organization, and
+[manage](#manage-extensions-policy) policies for Copilot in your organization.
+
+## Prerequisites
+
+Before you start, ensure that you're signed in to your GitHub account on
+GitHub.com.
+
+## Install
+
+To install the Docker for GitHub Copilot extension for your GitHub organization:
+
+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**.
+
+## Manage policies
+
+After installing the extension, you need to enable the Copilot Extensions
+policy. For instructions, 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).