[3rd-party IDE] Add Eclipse IDE to Copilot custom instructions documentation (#57007)

Author: sophietheking

content/copilot/concepts/response-customization.md

@@ -40,6 +40,11 @@ contentType: concepts
 > [!NOTE] This version of this article is about custom instructions in Xcode. Click the tabs above for other environments. <!-- markdownlint-disable-line MD027 -->
 {% endxcode %}
 
+{% eclipse %}
+
+> [!NOTE] This version of this article is about custom instructions in Eclipse. Click the tabs above for other environments. <!-- markdownlint-disable-line MD027 -->
+{% endeclipse %}
+
 ## About customizing {% data variables.copilot.copilot_chat %} responses
 
 {% webui %}
@@ -95,6 +100,17 @@ While custom instructions help to add codebase-wide context to each AI workflow,
 
 {% endxcode %}
 
+{% eclipse %}
+
+{% data variables.product.prodname_copilot %} can provide chat responses that are tailored to the way your team works, the tools you use, or the specifics of your project, if you provide it with enough context to do so. Instead of repeatedly adding this contextual detail to your chat questions, you can create a custom instructions file in your repository that automatically adds this information for you. The additional information is not displayed in the chat, but is available to {% data variables.product.prodname_copilot_short %} to allow it to generate higher quality responses.
+
+There are two types of repository custom instructions you can use to provide context and instructions to {% data variables.copilot.copilot_chat_short %} in Eclipse:
+
+* **Workspace custom instructions** which apply to all projects in a workspace, and allow you to specify workspace-wide instructions and preferences, in a single file.
+* **Project custom instructions** which apply to a specific project.
+
+{% endeclipse %}
+
 {% webui %}
 
 ## Using custom instructions
@@ -243,6 +259,26 @@ Common use cases include:
 
 {% endxcode %}
 
+{% eclipse %}
+
+## About repository custom instructions
+
+**Workspace custom instructions** apply to all projects in a workspace, and allow you to specify workspace-wide instructions and preferences. You can use workspace custom instructions to provide context and instructions to {% data variables.copilot.copilot_chat_short %} in Eclipse.
+
+**Project custom instructions** consist of a single file, `.github/copilot-instructions.md`, that you create in a project. The instructions you add to the file should be short, self-contained statements that add context or relevant information to supplement chat questions.
+
+Common use cases include:
+
+* **Test generation.** Create instructions for test generation, such as specifying the use of a certain test framework.
+* **Code review.** Specify instructions for reviewing code, such as telling a reviewer to look for a specific error in the code.
+* **Commit message generation.** Write instructions for generating commit messages, such as format or the type of information to include.
+
+### Example
+
+{% data reusables.copilot.repository-custom-instructions-example %}
+
+{% endeclipse %}
+
 ## Writing effective custom instructions
 
 The instructions you add should ideally be short, self-contained statements provide {% data variables.product.prodname_copilot_short %} with relevant information to help it work.
@@ -292,3 +328,15 @@ Answer all questions in less than 1000 characters, and words of no more than 12
 * [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot)
 
 {% endjetbrains %}
+
+{% xcode %}
+
+* [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot)
+
+{% endxcode %}
+
+{% eclipse %}
+
+* [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot)
+
+{% endeclipse %}

content/copilot/how-tos/configure-custom-instructions/add-repository-instructions.md

@@ -44,6 +44,14 @@ This version of this article is for using repository custom instructions in Xcod
 
 {% endxcode %}
 
+{% eclipse %}
+
+> [!NOTE] This feature is currently in {% data variables.release-phases.public_preview %} and is subject to change.
+
+This version of this article is for using repository custom instructions in Eclipse. Click the tabs above for instructions on using custom instructions in other environments.
+
+{% endeclipse %}
+
 ## About repository custom instructions for {% data variables.product.prodname_copilot_short %}
 
 Repository custom instructions let you provide {% data variables.product.prodname_copilot_short %} with repository-specific guidance and preferences.
@@ -84,6 +92,12 @@ Repository custom instructions let you provide {% data variables.product.prodnam
 
 {% endxcode %}
 
+{% eclipse %}
+
+* The latest version of the {% data variables.product.prodname_copilot_short %} extension must be installed in Eclipse.
+
+{% endeclipse %}
+
 ## Creating a repository custom instructions file
 
 {% jetbrains %}
@@ -143,6 +157,31 @@ Whitespace between instructions is ignored, so the instructions can be written a
 
 {% endxcode %}
 
+{% eclipse %}
+
+Eclipse supports two types of repository custom instructions: workspace and project custom instructions.
+
+To create a workspace custom instructions file, you can use the {% data variables.product.prodname_copilot_short %} settings page. To create a project custom instructions file, you can create the file manually in the project directory.
+
+Whitespace between instructions is ignored, so the instructions can be written as a single paragraph, each on a new line, or separated by blank lines for legibility.
+
+### Creating a workspace custom instructions file
+
+1. To open the {% data variables.copilot.copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse.
+1. From the menu, select "Edit preferences".
+1. In the left pane, expand {% data variables.product.prodname_copilot %} and click **Custom Instructions**.
+1. Select **Enable workspace instructions**.
+1. In the "Workspace" section, under "Set custom instructions to guide {% data variables.product.prodname_copilot_short %}'s code suggestions in this workspace", add natural language instructions to the file, in Markdown format.
+
+### Creating a project custom instructions file
+
+1. In the root of your project directory, create a file named `.github/copilot-instructions.md`.
+1. Add your custom instructions in natural language, using Markdown format.
+
+Once saved, these instructions will apply to the current project in Eclipse that you open with {% data variables.product.prodname_copilot_short %} enabled.
+
+{% endeclipse %}
+
 {% vscode %}
 
 {% data variables.product.prodname_vscode_shortname %} supports either:

data/reusables/copilot/repository-custom-instructions-support.md

@@ -1,5 +1,5 @@
 Repository custom instructions are currently supported for:
 * **{% data variables.copilot.copilot_chat_short %}** in {% data variables.product.prodname_vscode_shortname %}
 * **{% data variables.copilot.copilot_coding_agent %}**
-* **{% data variables.copilot.copilot_chat_short %}** in {% data variables.product.prodname_vs %}, JetBrains IDEs, Xcode, and on the {% data variables.product.github %} website (`copilot-instructions.md` file only)
+* **{% data variables.copilot.copilot_chat_short %}** in {% data variables.product.prodname_vs %}, JetBrains IDEs, Xcode, Eclipse, and on the {% data variables.product.github %} website (`copilot-instructions.md` file only)
 * **{% data variables.copilot.copilot_code-review_short %}** (`copilot-instructions.md` file only)