diff --git a/assets/images/help/copilot/add-to-copilot-space.png b/assets/images/help/copilot/add-to-copilot-space.png new file mode 100644 index 0000000000..c75848c64e Binary files /dev/null and b/assets/images/help/copilot/add-to-copilot-space.png differ diff --git a/content/copilot/concepts/context/spaces.md b/content/copilot/concepts/context/spaces.md index 7d8a73368a..6c893b8fc2 100644 --- a/content/copilot/concepts/context/spaces.md +++ b/content/copilot/concepts/context/spaces.md @@ -1,7 +1,7 @@ --- title: About GitHub Copilot Spaces shortTitle: Spaces -intro: Understand how organizing and sharing context with {% data variables.copilot.copilot_spaces %} can improve your {% data variables.copilot.copilot_chat_dotcom_short %} results and help your teammates. +intro: Understand how organizing and sharing context with {% data variables.copilot.copilot_spaces %} can improve your {% data variables.copilot.copilot_chat_dotcom_short %} results and help your collaborators. permissions: Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}. versions: feature: copilot @@ -19,7 +19,7 @@ category: - Learn about Copilot --- -{% data variables.copilot.copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. {% data variables.copilot.copilot_spaces_short %} can include repositories, code, pull requests, issues, free-text content like transcripts or notes, images, and file uploads. 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. +{% data variables.copilot.copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. {% data variables.copilot.copilot_spaces_short %} can include repositories, code, pull requests, issues, free-text content like transcripts or notes, images, and file uploads. You can ask {% data variables.product.prodname_copilot_short %} questions grounded in that context, or share the space with your team, or share publicly, to support collaboration and knowledge sharing. ## Why use {% data variables.copilot.copilot_spaces %}? @@ -38,7 +38,23 @@ Your spaces stay in sync as your project evolves. {% data variables.product.gith Anyone with a {% data variables.product.prodname_copilot_short %} license, including {% data variables.copilot.copilot_free_short %}, can create and use {% data variables.copilot.copilot_spaces_short %}. -{% data variables.copilot.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 or kept private to the person who created the space. +## Who can I share {% data variables.copilot.copilot_spaces_short %} with? + +{% data variables.copilot.copilot_spaces_short %} can belong to a personal account or to an organization, and the sharing options differ depending on who the space belongs to. + +### Organization-owned spaces + +Organization-owned spaces can be shared with other organization members, and you decide which level of access you want to grant other members (admin, editor, viewer). + +Alternatively, you can choose to grant "No access" to organization members, and keep the space hidden. + +### Individual-owned spaces + +Spaces belonging to a personal account can be shared publicly, shared with specific {% data variables.product.github %} users, or kept private to the person who created the space. + +Publicly shared spaces are view-only by default. + +Viewers can only see sources that they have access to. ## Where can I use {% data variables.copilot.copilot_spaces_short %}? diff --git a/content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-your-team.md b/content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-others.md similarity index 65% rename from content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-your-team.md rename to content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-others.md index ed488a6c37..97f2ea662f 100644 --- a/content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-your-team.md +++ b/content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-others.md @@ -1,7 +1,7 @@ --- -title: Collaborating with your team using GitHub Copilot Spaces -shortTitle: Collaborate with your team -intro: 'Learn how to share {% data variables.copilot.copilot_spaces %} with your team to support collaboration and knowledge sharing.' +title: Collaborating with others using GitHub Copilot Spaces +shortTitle: Collaborate with others +intro: 'Learn how to share {% data variables.copilot.copilot_spaces %} to support collaboration and knowledge sharing.' permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.' versions: feature: copilot @@ -12,21 +12,22 @@ redirect_from: - /copilot/how-tos/context/copilot-spaces/collaborating-with-your-team-using-copilot-spaces - /copilot/how-tos/context/copilot-spaces/collaborate-with-your-team - /copilot/how-tos/context/use-copilot-spaces/collaborate-with-your-team + - /copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-your-team contentType: how-tos category: - Author and optimize with Copilot --- -{% data variables.copilot.copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. Sharing {% data variables.copilot.copilot_spaces %} helps your team: +{% data variables.copilot.copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. Sharing {% data variables.copilot.copilot_spaces %} helps others: * 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. +* Get better help from {% data variables.product.prodname_copilot_short %} with grounded, curated context. -## Use cases for team collaboration +## Use cases for collaboration -* **Onboarding**: Share a space with code, documentation, diagrams, and checklists to help new developers get started faster. Make other members of your team editors so anyone can update the included resources. +* **Onboarding**: Share a space with code, documentation, diagrams, and checklists to help new developers get started faster. Make other people editors so anyone can update the included resources. * **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. @@ -34,14 +35,15 @@ For example, a subject matter expert creates a space called “Accessibility Rev ## Sharing {% data variables.copilot.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: +{% data variables.copilot.copilot_spaces_short %} can belong to a personal account or to an organization, and the sharing options differ depending on who the space belongs to. -* You can share the space with the organization, giving viewer, editor, or admin access to all organization members. -* You can give access to specific users or teams in the organization. For example, make everyone on your team an editor, or give admin access to a specific person so they can update the space's settings. +### Organization-owned spaces -If you choose to create a personal space, **you can't share it with others**. +Organization-owned spaces can be shared with other organization members, and you decide which level of access you want to grant other members (admin, editor, viewer). -To share a space with others: +Alternatively, you can choose to grant "No access" to organization members, and keep the space hidden. + +To share a organization-owned space with others: 1. In the top right corner of the space, click **{% octicon "share" aria-hidden="true" aria-label="share" %}**. 1. To add specific users or teams, search for them with the search bar, then choose a role for the people you added. @@ -50,9 +52,22 @@ To share a space with others: * **Viewers** can use the space to ask questions and view the included attachments and instructions. * **Editors** can update the space's attachments, description, name, and instructions, in addition to having all the permissions of viewers. However, editors can't update sharing settings or delete the space. * **Admins** can update sharing settings or delete the space, in addition to having all the permissions of viewers and editors. + * **No access** means the space will be hidden from other organization members. 1. Optionally, click **{% octicon "link" aria-label="the link" %} Copy link** to copy the link to the space and share it with others. +### Individual-owned spaces + +Spaces belonging to a personal account can be shared publicly, shared with specific {% data variables.product.github %} users, or kept private to the person who created the space. + +To share an individual-owned space with others: + +1. In the top right corner of the space, click **{% octicon "share" aria-hidden="true" aria-label="share" %}**. +1. To add specific {% data variables.product.github %} users, search for them with the search bar, then choose a role for the people you added. +1. Optionally, to make the space public, under "General access", select **Anyone with link**. Then, copy the link to the space and share it with others. + + > [!NOTE] Publicly shared spaces are view-only by default, and viewers can only see sources that they have access to. + ## Accessing shared {% data variables.copilot.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?ref_product=copilot&ref_type=engagement&ref_style=text). diff --git a/content/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces.md b/content/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces.md index 0d1725167d..04133ca4b2 100644 --- a/content/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces.md +++ b/content/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces.md @@ -49,6 +49,16 @@ You can add two types of context to your space: * **{% octicon "upload" aria-hidden="true" aria-label="upload" %} Upload a file**: You can upload files directly from your local machine. This includes images, text files, rich documents, and spreadsheets. * **{% octicon "paste" aria-hidden="true" aria-label="paste" %} Add text content**: You can type or paste free-text content, such as transcripts, notes, or any other relevant information that can help {% data variables.product.prodname_copilot_short %} understand the context of your space. +## Adding context as you're working + +You can add files to a space directly from the code view on {% data variables.product.github %}, so you don't need to break your flow when building context for your space. + +1. At the top of any file in the code view, click **{% octicon "space" aria-label="Add to space" %}**. + + ![Screenshot of a file in the code view. The "Add to space" icon is highlighted in orange.](/assets/images/help/copilot/add-to-copilot-space.png) + +1. From the dropdown, select the space you want to add the file to, or create a new space. + ## Next steps * To learn more about using {% data variables.copilot.copilot_spaces_short %} in {% data variables.product.github %} and your IDE, see [AUTOTITLE](/copilot/how-tos/provide-context/use-copilot-spaces/use-copilot-spaces). diff --git a/content/copilot/how-tos/provide-context/use-copilot-spaces/index.md b/content/copilot/how-tos/provide-context/use-copilot-spaces/index.md index a2b60383b6..122f397ab8 100644 --- a/content/copilot/how-tos/provide-context/use-copilot-spaces/index.md +++ b/content/copilot/how-tos/provide-context/use-copilot-spaces/index.md @@ -9,7 +9,7 @@ topics: children: - /create-copilot-spaces - /use-copilot-spaces - - /collaborate-with-your-team + - /collaborate-with-others redirect_from: - /copilot/using-github-copilot/copilot-spaces - /copilot/how-tos/context/copilot-spaces