You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/copilot/concepts/context/spaces.md
+19-3Lines changed: 19 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: About GitHub Copilot Spaces
3
3
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.
5
5
permissions: Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.
6
6
versions:
7
7
feature: copilot
@@ -19,7 +19,7 @@ category:
19
19
- Learn about Copilot
20
20
---
21
21
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.
23
23
24
24
## Why use {% data variables.copilot.copilot_spaces %}?
25
25
@@ -38,7 +38,23 @@ Your spaces stay in sync as your project evolves. {% data variables.product.gith
38
38
39
39
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 %}.
40
40
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.
42
58
43
59
## Where can I use {% data variables.copilot.copilot_spaces_short %}?
{% 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:
21
22
22
23
* Avoid repeated explanations and handoffs.
23
24
* Stay aligned on how a system works or what’s expected.
24
25
* 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.
26
27
27
-
## Use cases for team collaboration
28
+
## Use cases for collaboration
28
29
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.
30
31
***System knowledge**: Create a space for a complex system or workflow (like authentication or CI pipelines) that other people can reference.
31
32
***Style guides or review checklists**: Document standards and examples in a space that {% data variables.product.prodname_copilot_short %} can reference when suggesting changes.
32
33
33
34
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.
34
35
35
36
## Sharing {% data variables.copilot.copilot_spaces_short %}
36
37
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.
38
39
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
41
41
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).
43
43
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:
45
47
46
48
1. In the top right corner of the space, click **{% octicon "share" aria-hidden="true" aria-label="share" %}**.
47
49
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:
50
52
***Viewers** can use the space to ask questions and view the included attachments and instructions.
51
53
***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.
52
54
***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.
53
56
54
57
1. Optionally, click **{% octicon "link" aria-label="the link" %} Copy link** to copy the link to the space and share it with others.
55
58
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
+
56
71
## Accessing shared {% data variables.copilot.copilot_spaces_short %}
57
72
58
73
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).
Copy file name to clipboardExpand all lines: content/copilot/how-tos/provide-context/use-copilot-spaces/create-copilot-spaces.md
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,6 +49,16 @@ You can add two types of context to your space:
49
49
***{% 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.
50
50
***{% 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.
51
51
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
+

59
+
60
+
1. From the dropdown, select the space you want to add the file to, or create a new space.
61
+
52
62
## Next steps
53
63
54
64
* 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).
0 commit comments