Improve scannability of "Managing access for Copilot in your organization" (#50530)

Co-authored-by: Sarah Edwards <[email protected]>

Author: hubwriter

content/copilot/copilot-business/enabling-and-setting-up-github-copilot-business.md

@@ -45,7 +45,7 @@ Once an enterprise owner has enabled {% data variables.product.prodname_copilot_
 
 ## Assigning {% data variables.product.prodname_copilot %} seats
 
-To give people or teams within your organization access to {% data variables.product.prodname_copilot %}, you need to assign them a {% data variables.product.prodname_copilot %} seat. {% ifversion ghec %}Once a {% data variables.product.prodname_ghe_cloud %} admin enables a {% data variables.product.prodname_copilot_business_short %} subscription in your organization, you can assign {% data variables.product.prodname_copilot %} seats to individuals and teams in your organization.{% endif %} To enable access for all current and future users in your organization, or specific users in your organization, follow the steps in "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-in-your-organization)."
+To give people or teams within your organization access to {% data variables.product.prodname_copilot %}, you need to assign them a {% data variables.product.prodname_copilot %} seat. {% ifversion ghec %}Once a {% data variables.product.prodname_ghe_cloud %} admin enables a {% data variables.product.prodname_copilot_business_short %} subscription in your organization, you can assign {% data variables.product.prodname_copilot %} seats to individuals and teams in your organization.{% endif %} To enable access for all current and future users in your organization, or specific users in your organization, follow the steps in "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization)."
 
 ## Configuring network settings
 

content/copilot/github-copilot-enterprise/overview/enabling-github-copilot-enterprise-features.md

@@ -17,7 +17,7 @@ To enable users to use {% data variables.product.prodname_copilot_enterprise_sho
 Access to {% data variables.product.prodname_copilot_short %} is determined at the enterprise and organization levels:
 
 - Enterprise owners can allow some or all of the organizations in the enterprise to access {% data variables.product.prodname_copilot_short %}. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise#managing-access-to-github-copilot-in-your-enterprise)."
-- Owners of organizations that have been granted access to {% data variables.product.prodname_copilot_short %} can assign {% data variables.product.prodname_copilot_enterprise %} seats to some or all members of their organization. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-in-your-organization)."
+- Owners of organizations that have been granted access to {% data variables.product.prodname_copilot_short %} can assign {% data variables.product.prodname_copilot_enterprise %} seats to some or all members of their organization. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/managing-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization)."
 
 When access to {% data variables.product.prodname_copilot_short %} has been enabled, features such as the ability to use {% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %}, can be configured. Features are enabled or disabled at the enterprise or organization level:
 
@@ -40,17 +40,25 @@ An enterprise owner can choose whether to enable {% data variables.product.prodn
 
 ## Enabling or disabling {% data variables.product.prodname_copilot_enterprise_short %} features for an organization
 
-To give people or teams within your organization access to {% data variables.product.prodname_copilot_enterprise %}, you need to assign them a {% data variables.product.prodname_copilot %} seat. Once a {% data variables.product.prodname_ghe_cloud %} admin enables a {% data variables.product.prodname_copilot_enterprise_short %} subscription in your organization, you can assign {% data variables.product.prodname_copilot %} seats to individuals and teams in your organization. To enable access for all current and future users in your organization, or specific users in your organization, follow the steps in "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-in-your-organization#configuring-access-to-github-copilot-in-your-organization)."
+Organization owners can enable or disable {% data variables.product.prodname_copilot_enterprise_short %} for all members of their organization that have access to {% data variables.product.prodname_copilot_enterprise_short %}, provided no specific policy has been set to enable or disable {% data variables.product.prodname_copilot_enterprise_short %} at the enterprise level.
 
-If your organization's parent enterprise has selected **No policy** for "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" in the enterprise settings, {% data variables.product.prodname_copilot_enterprise %} will be disabled by default for your organization. If you are an owner of the organization, you can choose to enable or disable the additional features provided by {% data variables.product.prodname_copilot_enterprise %} for all of the organization's members who have access to {% data variables.product.prodname_copilot_short %}.
+### Granting access to {% data variables.product.prodname_copilot_short %}
+
+To give members of your organization access to the features of {% data variables.product.prodname_copilot_enterprise_short %} those members must have access to {% data variables.product.prodname_copilot_short %}. This is achieved by assigning seats for {% data variables.product.prodname_copilot_short %}. Once a {% data variables.product.prodname_ghe_cloud %} admin enables a {% data variables.product.prodname_copilot_enterprise_short %} subscription in your organization, you can assign {% data variables.product.prodname_copilot %} seats to individuals and teams in the organization. See "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization#configuring-access-to-github-copilot-in-your-organization)."
+
+### Enabling or disabling {% data variables.product.prodname_copilot_enterprise_short %}
+
+{% data variables.product.prodname_copilot_enterprise_short %} can be enabled or disabled at either the enterprise or organization level.
+
+If your organization's parent enterprise has selected **No policy** for "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" in the enterprise settings, {% data variables.product.prodname_copilot_enterprise %} will initially be disabled for your organization. If you are an owner of the organization, you can choose to enable the additional features provided by {% data variables.product.prodname_copilot_enterprise %} for all of the organization's members who have access to {% data variables.product.prodname_copilot_short %}.
 
 {% data reusables.profile.access_org %}
 {% data reusables.profile.org_settings %}
 {% data reusables.copilot.policy-settings %}
 
    {% note %}
 
-   **Note:** If the side panel only contains the **Access** option under **{% octicon "copilot" aria-hidden="true" %} {% data variables.product.prodname_copilot_short %}**, you need to allow the organization to assign {% data variables.product.prodname_copilot_short %} seats. Complete the steps for configuring {% data variables.product.prodname_copilot_short %} access in "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-in-your-organization#configuring-access-to-github-copilot-in-your-organization)" and then return to this procedure.
+   **Note:** If the side panel only contains the **Access** option under **{% octicon "copilot" aria-hidden="true" %} {% data variables.product.prodname_copilot_short %}**, it indicates that {% data variables.product.prodname_copilot_short %} is not currently available in the organization. An enterprise admin must enable {% data variables.product.prodname_copilot_short %} for your organization. See "[AUTOTITLE](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise#managing-access-to-github-copilot-in-your-enterprise)." After {% data variables.product.prodname_copilot_short %} is enabled for the organization, return to this procedure.
 
    {% endnote %}
 

content/copilot/managing-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization.md

@@ -0,0 +1,90 @@
+---
+title: Granting access to Copilot for members of your organization
+shortTitle: Granting access
+intro: 'Grant access to {% data variables.product.prodname_copilot %} for some or all of the members of your organization.'
+permissions: Organization owners for organizations with a subscription to {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or{% endif %} {% data variables.product.prodname_copilot_business_short %}.
+versions:
+  feature: copilot
+redirect_from:
+  - /copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-in-your-organization
+  - /copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-business-in-your-organization
+  - /copilot/managing-copilot-for-business/managing-access-for-copilot-for-business-in-your-organization
+  - /copilot/managing-copilot-business/managing-access-for-copilot-business-in-your-organization
+topics:
+  - Copilot
+---
+
+## Configuring access to {% data variables.product.prodname_copilot %} in your organization
+
+{% ifversion ghec %}After a {% data variables.product.prodname_dotcom %} enterprise owner enables {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} for an organization, an owner of that organization can grant {% data variables.product.prodname_copilot %} access to members of their organization.{% else %}After setting up a {% data variables.product.prodname_copilot_business_short %} subscription, an organization owner grant {% data variables.product.prodname_copilot %} access to members of their organization.{% endif %}
+
+Billing for {% data variables.product.prodname_copilot %} starts when you grant an organization member access, irrespective of when they first use {% data variables.product.prodname_copilot_short %}. If you grant an organization member access midway through a billing cycle, the cost is prorated for the remainder of the cycle. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)."
+
+## Granting access to {% data variables.product.prodname_copilot %} for all current and future users in your organization
+
+{% data reusables.profile.access_org %}
+{% data reusables.profile.org_settings %}
+{% data reusables.copilot.access-settings %}
+1. If the **Allow this organization to assign seats** button is displayed, click this button.
+1. If you see the message "Configure code policies to start adding seats":
+   1. Click **Go to policies**.
+   1. Set any policies that are currently set to "Unconfigured".
+   1. In the left sidebar, click **Access**.
+1. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," to enable {% data variables.product.prodname_copilot %} for all current and future users in your organization, select **Enabled For: All members of the organization**.
+1. In the "Confirm seats purchase" dialog, to confirm that you want to enable {% data variables.product.prodname_copilot %} for all current and future users in your organization, click **Purchase seats**.
+
+## Granting access to {% data variables.product.prodname_copilot %} for specific users in your organization
+
+{% ifversion ghec %}
+{% note %}
+
+**Note:** You can automatically enable access for every member of a group in your identity provider (IdP) by synchronizing that group with a {% data variables.product.prodname_dotcom %} team, then giving that team access to {% data variables.product.prodname_copilot %}.  For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)."
+
+{% endnote %}
+{% endif %}
+
+{% data reusables.profile.access_org %}
+{% data reusables.profile.org_settings %}
+{% data reusables.copilot.access-settings %}
+1. If the **Allow this organization to assign seats** button is displayed, click this button.
+1. If you see the message "Configure code policies to start adding seats":
+   1. Click **Go to policies**.
+   1. Set any policies that are currently set to "Unconfigured".
+   1. In the left sidebar, click **Access**.
+1. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," to enable {% data variables.product.prodname_copilot %} for selected teams or users in your organization, select **Enabled For: Selected members**.
+1. If you are updating user access from the **Enabled For: All members of the organization** setting, in the "Confirm policy update" dialog, select how you want to start assigning access.
+    - To unassign all members and then select those who should have access, select **Start from scratch**.
+    - To keep all members who currently have access and then select those who should not have access, select **Renew seats**.
+1. Click **Assign {% data variables.product.prodname_copilot_short %} seats**.
+1. In the "Enable Copilot access for users and teams" dialog, click one of the two tabs.
+
+   ![Screenshot of the "enable access for selected members" dialog.](/assets/images/help/copilot/enable-access-for-selected-members.png)
+
+   - Click **Users and teams** to search for and add individual users or teams.
+
+     To search for a user, type their username or full name in the search bar. If you select a user who is not currently a member of your organization, they will be invited to join your organization when you click **Continue to purchase** followed by **Purchase seats**.
+
+   - Click **Upload CSV** to add users in bulk by uploading a CSV file.
+
+     To add members in bulk, click **Choose CSV to upload**, and then upload a CSV file including either the username or email address for each member you want to add, separated by a comma. The file can contain a mixture of usernames and email addresses.
+
+     {% warning %}
+
+     **Warning:** When you upload a CSV file, unless you're using {% data variables.product.prodname_emus %}, {% data variables.product.prodname_copilot %} will search all users on {% data variables.product.prodname_dotcom_the_website %} for matches. If the CSV includes users who are not members of your organization, they will be invited to join your organization when you click **Continue to purchase** followed by **Purchase seats**. This warning does not apply to accounts using {% data variables.product.prodname_emus %}.
+
+     {% endwarning %}
+
+     Review the list of users generated from your CSV file. Clear the selection of any users you do not want to add.
+
+1. Click **Continue to purchase**, then click **Purchase seats**.
+
+## Using the API to grant access to {% data variables.product.prodname_copilot %}
+
+You can use {% data variables.product.prodname_dotcom %}'s REST API to grant access to {% data variables.product.prodname_copilot %} for teams, or specific users, in your organization. See "[Add teams to the Copilot subscription for an organization](/rest/copilot/copilot-user-management?apiVersion=2022-11-28#add-teams-to-the-copilot-subscription-for-an-organization)" and "[Add users to the Copilot subscription for an organization](/rest/copilot/copilot-user-management?apiVersion=2022-11-28#add-users-to-the-copilot-subscription-for-an-organization)."
+
+## Further reading
+
+- [{% data variables.product.prodname_copilot %} Trust Center](https://resources.github.com/copilot-trust-center)
+- "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization)"
+- "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/reviewing-usage-data-for-github-copilot-in-your-organization)"
+- "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/revoking-access-to-copilot-for-members-of-your-organization)"

content/copilot/managing-github-copilot-in-your-organization/index.md

@@ -8,7 +8,9 @@ topics:
   - Copilot
   - CLI
 children:
-  - /managing-access-for-copilot-in-your-organization
+  - /granting-access-to-copilot-for-members-of-your-organization
+  - /revoking-access-to-copilot-for-members-of-your-organization
+  - /reviewing-usage-data-for-github-copilot-in-your-organization
   - /managing-policies-and-features-for-copilot-in-your-organization
   - /configuring-content-exclusions-for-github-copilot
   - /reviewing-your-organization-or-enterprises-audit-logs-for-copilot-business