Skip to content

Commit c9d0396

Browse files
authored
Copilot Spaces - Updates (add file from code view, public sharing) (#58569)
1 parent 9538181 commit c9d0396

File tree

5 files changed

+57
-16
lines changed

5 files changed

+57
-16
lines changed
63.2 KB
Loading

content/copilot/concepts/context/spaces.md

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: About GitHub Copilot Spaces
33
shortTitle: Spaces
4-
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.
4+
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.
55
permissions: Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.
66
versions:
77
feature: copilot
@@ -19,7 +19,7 @@ category:
1919
- Learn about Copilot
2020
---
2121

22-
{% 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.
22+
{% 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.
2323

2424
## Why use {% data variables.copilot.copilot_spaces %}?
2525

@@ -38,7 +38,23 @@ Your spaces stay in sync as your project evolves. {% data variables.product.gith
3838

3939
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 %}.
4040

41-
{% 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.
41+
## Who can I share {% data variables.copilot.copilot_spaces_short %} with?
42+
43+
{% 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.
44+
45+
### Organization-owned spaces
46+
47+
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).
48+
49+
Alternatively, you can choose to grant "No access" to organization members, and keep the space hidden.
50+
51+
### Individual-owned spaces
52+
53+
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.
54+
55+
Publicly shared spaces are view-only by default.
56+
57+
Viewers can only see sources that they have access to.
4258

4359
## Where can I use {% data variables.copilot.copilot_spaces_short %}?
4460

content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-your-team.md renamed to content/copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-others.md

Lines changed: 27 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Collaborating with your team using GitHub Copilot Spaces
3-
shortTitle: Collaborate with your team
4-
intro: 'Learn how to share {% data variables.copilot.copilot_spaces %} with your team to support collaboration and knowledge sharing.'
2+
title: Collaborating with others using GitHub Copilot Spaces
3+
shortTitle: Collaborate with others
4+
intro: 'Learn how to share {% data variables.copilot.copilot_spaces %} to support collaboration and knowledge sharing.'
55
permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.'
66
versions:
77
feature: copilot
@@ -12,36 +12,38 @@ redirect_from:
1212
- /copilot/how-tos/context/copilot-spaces/collaborating-with-your-team-using-copilot-spaces
1313
- /copilot/how-tos/context/copilot-spaces/collaborate-with-your-team
1414
- /copilot/how-tos/context/use-copilot-spaces/collaborate-with-your-team
15+
- /copilot/how-tos/provide-context/use-copilot-spaces/collaborate-with-your-team
1516
contentType: how-tos
1617
category:
1718
- Author and optimize with Copilot
1819
---
1920

20-
{% 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:
21+
{% 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:
2122

2223
* Avoid repeated explanations and handoffs.
2324
* Stay aligned on how a system works or what’s expected.
2425
* Learn from past work, documentation, and examples.
25-
* Get better help from {% data variables.product.prodname_copilot_short %} with grounded, team-curated context.
26+
* Get better help from {% data variables.product.prodname_copilot_short %} with grounded, curated context.
2627

27-
## Use cases for team collaboration
28+
## Use cases for collaboration
2829

29-
* **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.
30+
* **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.
3031
* **System knowledge**: Create a space for a complex system or workflow (like authentication or CI pipelines) that other people can reference.
3132
* **Style guides or review checklists**: Document standards and examples in a space that {% data variables.product.prodname_copilot_short %} can reference when suggesting changes.
3233

3334
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.
3435

3536
## Sharing {% data variables.copilot.copilot_spaces_short %}
3637

37-
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:
38+
{% 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.
3839

39-
* You can share the space with the organization, giving viewer, editor, or admin access to all organization members.
40-
* 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.
40+
### Organization-owned spaces
4141

42-
If you choose to create a personal space, **you can't share it with others**.
42+
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).
4343

44-
To share a space with others:
44+
Alternatively, you can choose to grant "No access" to organization members, and keep the space hidden.
45+
46+
To share a organization-owned space with others:
4547

4648
1. In the top right corner of the space, click **{% octicon "share" aria-hidden="true" aria-label="share" %}**.
4749
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:
5052
* **Viewers** can use the space to ask questions and view the included attachments and instructions.
5153
* **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.
5254
* **Admins** can update sharing settings or delete the space, in addition to having all the permissions of viewers and editors.
55+
* **No access** means the space will be hidden from other organization members.
5356

5457
1. Optionally, click **{% octicon "link" aria-label="the link" %} Copy link** to copy the link to the space and share it with others.
5558

59+
### Individual-owned spaces
60+
61+
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.
62+
63+
To share an individual-owned space with others:
64+
65+
1. In the top right corner of the space, click **{% octicon "share" aria-hidden="true" aria-label="share" %}**.
66+
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.
67+
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.
68+
69+
> [!NOTE] Publicly shared spaces are view-only by default, and viewers can only see sources that they have access to.
70+
5671
## Accessing shared {% data variables.copilot.copilot_spaces_short %}
5772

5873
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).

content/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,16 @@ You can add two types of context to your space:
4949
* **{% 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.
5050
* **{% 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.
5151

52+
## Adding context as you're working
53+
54+
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.
55+
56+
1. At the top of any file in the code view, click **{% octicon "space" aria-label="Add to space" %}**.
57+
58+
![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)
59+
60+
1. From the dropdown, select the space you want to add the file to, or create a new space.
61+
5262
## Next steps
5363

5464
* 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).

content/copilot/how-tos/provide-context/use-copilot-spaces/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ topics:
99
children:
1010
- /create-copilot-spaces
1111
- /use-copilot-spaces
12-
- /collaborate-with-your-team
12+
- /collaborate-with-others
1313
redirect_from:
1414
- /copilot/using-github-copilot/copilot-spaces
1515
- /copilot/how-tos/context/copilot-spaces

0 commit comments

Comments
 (0)