Enhanced permissions for spaces: teams, users, and write permissions (#56864)

Author: isaacmbrown

content/copilot/concepts/spaces.md

@@ -49,7 +49,7 @@ Anyone with a {% data variables.product.prodname_copilot_short %} license, inclu
 
 During the {% data variables.release-phases.public_preview %}, if you're using a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, the organization or enterprise that provides your plan must have the **Opt in to preview features** setting enabled. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) or [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom).
 
-{% 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 (read-only) or kept private to the person who created the space.
+{% 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.
 
 ## How does using {% data variables.copilot.copilot_spaces_short %} affect my usage?
 

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

@@ -26,7 +26,7 @@ contentType: how-tos
 
 ## Use cases for team collaboration
 
-* **Onboarding**: Share a space with code, documentation, diagrams, and checklists to help new developers get started faster.
+* **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.
 * **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.
 
@@ -36,17 +36,22 @@ For example, a subject matter expert creates a space called “Accessibility Rev
 
 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.
+* 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.
 
 If you choose to create a personal space, **you can't share it with others**.
 
-To share a space with your organization:
+To share a space with others:
 
 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".
+1. To add specific users or teams, search for them with the search bar, then choose a role for the people you added.
+1. Optionally, next to your organization's name, choose a base role for all other organization members.
 
-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.
+   * **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.
+
+1. Optionally, 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.copilot.copilot_spaces_short %}