Merge pull request #38610 from github/repo-sync

Repo sync

Author: docs-bot

.github/copilot-instructions.md

@@ -0,0 +1,17 @@
+This documentation repository consists mainly of content written in Markdown format. These files are converted into HTML for displaying on a website. Most Markdown files become a single article on the documentation site. Other files contain reusable content which is inserted into multiple articles. The repository also contains YAML files (e.g. for variable text), image files, JavaScript/TypeScript files, etc.
+
+### Using variables
+
+Within Markdown files, with the exception of the `title` field in the metadata at the start of a file, always use the Liquid syntax variables rather than text if a variable has been defined for that text. For example:
+
+| Use this variable | Don't use this text | File where variable is defined |
+| --- | --- | --- |
+| `{% data variables.product.prodname_dotcom %}` | GitHub | data/variables/product.yml |
+| `{% data variables.product.prodname_ghe_server %}` | GitHub Enterprise Server | data/variables/product.yml | 
+| `{% data variables.product.prodname_copilot_short %}` | Copilot | data/variables/product.yml | 
+| `{% data variables.product.prodname_copilot %}` | GitHub Copilot | data/variables/product.yml | 
+| `{% data variables.copilot.copilot_code-review_short %}` | Copilot code review | data/variables/copilot.yml | 
+| `{% data variables.enterprise.prodname_managed_user %}` | managed user account | data/variables/enterprise.yml | 
+| `{% data variables.code-scanning.codeql_workflow %}` | CodeQL analysis workflow | data/variables/code-scanning.yml | 
+
+There are many more variables. These are stored in various YAML files within the `data/variables` directory.

content/copilot/about-github-copilot/github-copilot-features.md

@@ -68,6 +68,10 @@ Enhance {% data variables.product.prodname_copilot_chat_short %} responses by pr
 
 Automatically generate commit messages and descriptions with {% data variables.product.prodname_copilot_desktop_short %} based on the changes you make to your project.
 
+### {% data variables.product.prodname_copilot_spaces %} ({% data variables.release-phases.public_preview %})
+
+Organize and centralize relevant content—like code, docs, specs, and more—into {% data variables.product.prodname_copilot_spaces_short %} that ground {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces).
+
 ### {% 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_dotcom_short %} or in {% data variables.product.prodname_vscode_shortname %}, you can specify a knowledge base as the context for your question. See [AUTOTITLE](/copilot/customizing-copilot/managing-copilot-knowledge-bases).

content/copilot/about-github-copilot/what-is-github-copilot.md

@@ -36,6 +36,7 @@ redirect_from:
 * Get code suggestions as you type in your IDE
 * Chat with {% data variables.product.prodname_copilot_short %} to ask for help with your code
 * Ask {% data variables.product.prodname_copilot_short %} for help using the command line
+* Organize and share task-specific context with {% data variables.product.prodname_copilot_spaces %} to get more relevant answers
 * Generate a description of the changes in a pull request _({% data variables.product.prodname_copilot_enterprise_short %} only)_
 * Create and manage collections of documentation, called knowledge bases, to use as a context for chatting with {% data variables.product.prodname_copilot_short %} _({% data variables.product.prodname_copilot_enterprise_short %} only)_
 * Work on code changes and create a pull request for you to review _({% data variables.product.prodname_copilot_pro_plus_short %} and {% data variables.product.prodname_copilot_enterprise_short %} only)_

content/copilot/customizing-copilot/managing-copilot-knowledge-bases.md

@@ -20,6 +20,10 @@ redirect_from:
   - /copilot/github-copilot-enterprise/copilot-docset-management/about-copilot-docset-management
 ---
 
+> [!TIP] If you're looking for a more flexible way to organize context for {% data variables.product.prodname_copilot_short %}, you can also try {% data variables.product.prodname_copilot_spaces %}.
+>
+> {% data variables.product.prodname_copilot_spaces_short %} let you combine code and free-text content—like transcripts or specs—and can be created by any {% data variables.product.prodname_copilot_short %} user, not just organization owners. They’re a good option for more focused or task-specific use cases. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces).
+
 ## About knowledge bases
 
 Organization owners can create knowledge bases, bringing together Markdown documentation across one or more repositories. Organization members can then specify that knowledge base as the context for {% data variables.product.prodname_copilot_chat_dotcom_short %}, {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, and {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}.

content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md

@@ -32,6 +32,7 @@ Organization owners can set policies to govern how {% data variables.product.pro
   * Image support in {% data variables.product.prodname_copilot_chat_short %} (available in {% data variables.product.prodname_vscode_shortname %} and {% data variables.product.prodname_vs %})
     >[!NOTE] This setting only applies to preview features within {% data variables.product.prodname_copilot_short %} and does not control all preview-related settings in {% data variables.product.prodname_vscode_shortname %}.
 * {% data variables.copilot.copilot_coding_agent %} ({% data variables.release-phases.public_preview %})
+* {% data variables.product.prodname_copilot_spaces %} (public preview)
 * MCP servers on {% data variables.product.prodname_dotcom_the_website %} ({% data variables.release-phases.public_preview %})
 * {% data variables.product.prodname_copilot_mobile_short %}
 * {% data variables.product.prodname_copilot_cli_short %} and {% data variables.product.prodname_windows_terminal %}

content/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces.md

@@ -0,0 +1,58 @@
+---
+title: About organizing and sharing context with Copilot Spaces
+shortTitle: Organize and share context
+intro: 'Understand how gathering context with {% data variables.product.prodname_copilot_spaces %} can improve your results and help your teammates.'
+permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.'
+versions:
+  feature: copilot
+type: overview
+topics:
+  - Copilot
+---
+
+{% data reusables.copilot.copilot-spaces.preview-note %}
+
+{% data variables.product.prodname_copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. {% data variables.product.prodname_copilot_spaces_short %} can include code from repositories, free-text content like transcripts or notes, and more—grouped together in one place. You can ask {% data variables.product.prodname_copilot_short %} questions grounded in that context, or share the space with your team to support collaboration and knowledge sharing.
+
+## Why use {% data variables.product.prodname_copilot_spaces %}?
+
+Whether you’re working solo or collaborating across a team, {% data variables.product.prodname_copilot_spaces_short %} help you make {% data variables.product.prodname_copilot_short %} more useful.
+
+With {% data variables.product.prodname_copilot_spaces %} you can:
+
+* Get more relevant, specific answers from {% data variables.product.prodname_copilot_short %}.
+* Stay in flow by collecting what you need for a task in one place.
+* Reduce repeated questions by sharing knowledge with your team.
+* Support onboarding and reuse with self-service context that lives beyond chat history.
+
+### How are {% data variables.product.prodname_copilot_spaces_short %} different from knowledge bases?
+
+{% data variables.product.prodname_copilot_spaces_short %} are optimized for specific tasks and grounded conversations. Because context in {% data variables.product.prodname_copilot_spaces_short %} is scoped, {% data variables.product.prodname_copilot_short %}'s responses are more accurate and relevant.
+
+{% rowheaders %}
+
+|                      | {% data variables.product.prodname_copilot_spaces %}         | Knowledge bases                                             |
+| -------------------- | --------------------------- | -------------------------------------------------------------- |
+| Who can create   | Anyone with a {% data variables.product.prodname_copilot_short %} license             | Organization owners                                              |
+| Owned by   | Organizations or individual users              | Organizations                             |
+| Content type     | Any code hosted in repositories and free-text content                  | Markdown files hosted in {% data variables.product.github %}
+| Context handling | Limited in size, which guarantees higher response quality given the focused selection | Unlimited, but that comes with reduced response quality |
+
+{% endrowheaders %}
+
+## Who can use {% data variables.product.prodname_copilot_spaces_short %}?
+
+Anyone with a {% data variables.product.prodname_copilot_short %} license, including {% data variables.product.prodname_copilot_free_short %}, can create and use {% data variables.product.prodname_copilot_spaces_short %}.
+
+{% data reusables.copilot.editor-preview-settings %}
+
+{% data variables.product.prodname_copilot_spaces_short %} can belong to a personal account or to an organization. Spaces owned by an organization can be shared with other organization members (read-only) or kept private to the person who created the space.
+
+Questions you submit in a space count as {% data variables.product.prodname_copilot_chat_short %} requests.
+
+* If you're a {% data variables.product.prodname_copilot_free_short %} user, this usage counts toward your monthly chat limit.
+* If you use {% data variables.product.prodname_copilot_spaces_short %} with a premium model, this usage counts toward your premium usage quota.
+
+## Next steps
+
+To start using {% data variables.product.prodname_copilot_spaces_short %}, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces).

content/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces.md

@@ -0,0 +1,48 @@
+---
+title: Collaborating with your team using Copilot Spaces
+shortTitle: Collaborate with your team
+intro: 'Learn how to share {% data variables.product.prodname_copilot_spaces %} with your team to support collaboration and knowledge sharing.'
+permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.'
+versions:
+  feature: copilot
+type: how_to
+topics:
+  - Copilot
+---
+
+{% data reusables.copilot.copilot-spaces.preview-note %}
+
+{% data variables.product.prodname_copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. Sharing {% data variables.product.prodname_copilot_spaces %} helps your team:
+
+* Avoid repeated explanations and handoffs.
+* Stay aligned on how a system works or what’s expected.
+* Learn from past work, documentation, and examples.
+* Get better help from {% data variables.product.prodname_copilot_short %} with grounded, team-curated context.
+
+## Use cases for team collaboration
+
+* **Onboarding**: Share a space with key code, docs, and checklists to help new developers get started faster.
+* **System knowledge**: Create a space for a complex system or workflow (like authentication or CI pipelines) that other people can reference.
+* **Style guides or review checklists**: Document standards and examples in a space that {% data variables.product.prodname_copilot_short %} can reference when suggesting changes.
+
+For example, a subject matter expert creates a space called “Accessibility Reviews” that includes your team’s internal accessibility checklist, product guidelines, and WCAG documentation. Developers can ask {% data variables.product.prodname_copilot_short %} questions directly in the space to ensure they're following the latest guidelines in their work.
+
+## Sharing {% data variables.product.prodname_copilot_spaces_short %}
+
+When you create a space, you can choose whether it’s owned by you or by one of your organizations. If you choose an organization:
+
+* You can share the space with others in the organization, giving read access to all organization members.
+* Other people with access can view the context, use {% data variables.product.prodname_copilot_short %} within the space, and ask questions.
+
+If you choose to create a personal space, **you can't share it with others**.
+
+To share a space with your organization:
+
+1. In the top right corner of the space, click **{% octicon "kebab-horizontal" aria-hidden="true" aria-label="kebab-horizontal" %}**, then click **{% octicon "share" aria-hidden="true" aria-label="share" %} Share**.
+1. Change the base role to "The entire organization can access".
+
+Other people in your organization can now view the space in the "Organizations" tab and use it to ask questions. Additionally, you can also click **{% octicon "link" aria-label="the link" %} Copy link** to copy the link to the space and share it with others.
+
+## Accessing shared {% data variables.product.prodname_copilot_spaces_short %}
+
+If you’re part of an organization that has shared spaces, you can access them in the **Organizations** tab on [https://github.com/copilot/spaces](https://github.com/copilot/spaces).

content/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces.md

@@ -0,0 +1,46 @@
+---
+title: Creating and using Copilot Spaces
+shortTitle: Create and use Copilot Spaces
+intro: 'Create spaces to organize and centralize relevant content that grounds {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task.'
+permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.'
+versions:
+  feature: copilot
+type: how_to
+topics:
+  - Copilot
+---
+
+{% data reusables.copilot.copilot-spaces.preview-note %}
+
+1. To create a space, go to [https://github.com/copilot/spaces](https://github.com/copilot/spaces), and click **Create space**.
+1. Give your space a name.
+1. Choose whether the space is owned by you or by an organization you belong to. Organization-owned {% data variables.product.prodname_copilot_spaces_short %} can be shared using {% data variables.product.github %}’s built-in permission model.
+1. Optionally, add a description to help others understand the purpose of the space.
+1. Click **Create**.
+
+## Adding context to {% data variables.product.prodname_copilot_spaces_short %}
+
+You can add two types of context to your space:
+
+* **Instructions**: Free text that describes what {% data variables.product.prodname_copilot_short %} should focus on within this space. Include its areas of expertise, what kinds of tasks it should help with, and what it should avoid. This helps {% data variables.product.prodname_copilot_short %} give more relevant responses based on your intent.
+
+   For example:
+
+   > You are a SQL generator. Your job is to take the sample queries and data schemas defined in the attached files and and generate SQL queries based on the user's goals.
+
+* **References**: You can add any code hosted in {% data variables.product.github %} repositories, including public and private repositories. You can also add free-text content, such as transcripts or notes.
+
+   >[!TIP] You don’t need formal docs to get value from {% data variables.product.prodname_copilot_spaces_short %}. Try pasting in a Slack thread, a video call summary, or even bullet-point notes.
+
+This context will be used to provide more relevant answers to your questions. Additionally, {% data variables.product.prodname_copilot_spaces_short %} will always refer to the latest version of the code on the `main` branch of the repository.
+
+## Using {% data variables.product.prodname_copilot_spaces_short %}
+
+Once you've added context to your space, you can ask {% data variables.product.prodname_copilot_short %} questions in the chat interface. Your chat will be grounded in the context you've added.
+
+You can also change the large language model (LLM) used for your space by selecting the **CURRENT-MODEL** {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu, then clicking the AI model of your choice. For more information about choosing the right AI model, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task).
+
+## Next steps
+
+* To learn more about how to use {% data variables.product.prodname_copilot_spaces_short %} to help you with development work, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces).
+* To learn how to share your space with your team, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces).

content/copilot/using-github-copilot/copilot-spaces/index.md

@@ -0,0 +1,13 @@
+---
+title: Copilot Spaces
+intro: "Organize and centralize relevant content into {% data variables.product.prodname_copilot_spaces_short %} that ground {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task."
+versions:
+  feature: copilot
+topics:
+  - Copilot
+children:
+  - /about-organizing-and-sharing-context-with-copilot-spaces
+  - /creating-and-using-copilot-spaces
+  - /speeding-up-development-work-with-copilot-spaces
+  - /collaborating-with-your-team-using-copilot-spaces
+---