[May 16] Self-serve available for GHEC with data residency (#55633)

Co-authored-by: Copilot <[email protected]>

Author: isaacmbrown

content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md

@@ -14,7 +14,9 @@ redirect_from:
 
 By default, {% data variables.product.company_short %} stores data for {% data variables.product.prodname_dotcom_the_website %} in the USA. {% data reusables.data-residency.when-you-adopt-data-residency %} To learn how {% data variables.product.company_short %} handles data storage, see [AUTOTITLE](/admin/data-residency/about-storage-of-your-data-with-data-residency).
 
-To get {% data variables.enterprise.data_residency_short %} for your enterprise, **contact {% data variables.contact.contact_sales_data_residency %}**.
+You can **get started with data residency** by setting up a trial of {% data variables.product.prodname_ghe_cloud %}.
+
+<a href="https://github.com/account/enterprises/new?ref_cta=GHEC+trial&ref_loc=about+ghec+with+data+residency&ref_page=docs" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Set up a trial of {% data variables.product.prodname_ghe_cloud %}</span> {% octicon "link-external" height:16 %}</a>
 
 ## What is {% data variables.product.prodname_ghe_cloud %}?
 
@@ -107,7 +109,7 @@ When reading the documentation, readers may need to substitute references to {%
 
 ## Getting started
 
-When you have worked with your account team to create a new enterprise account and choose a subdomain on {% data variables.enterprise.data_residency_site %}, you can get started with your new enterprise.
+Once you have signed up for the trial to create a new enterprise account and choose a subdomain on {% data variables.enterprise.data_residency_site %}, you can get started with your new enterprise.
 
 You will:
 

content/admin/data-residency/getting-started-with-data-residency-for-github-enterprise-cloud.md

@@ -17,24 +17,46 @@ redirect_from:
 
 When you adopt {% data variables.enterprise.data_residency %}, you can choose where your company's code and data are stored.
 
-After you have **worked with {% data variables.contact.contact_sales_data_residency %}** to create an enterprise account with a dedicated URL on {% data variables.enterprise.data_residency_site %}, you'll use this guide to set up your enterprise. You will:
+In this guide, you will:
 
+* Start a trial to create an enterprise account with {% data variables.enterprise.data_residency_short %} and a dedicated domain on {% data variables.enterprise.data_residency_site %}
 * Add users by configuring authentication and provisioning with an identity management system
+* Learn about available features, including features that work differently or require additional configuration compared to {% data variables.product.prodname_dotcom_the_website %}
 * Set up billing for your enterprise
 * Optionally, migrate data from another platform
-* Learn about available features, including features that work differently or require additional configuration
 
 After this initial setup, you'll be able to create organizations and repositories, collaborate on code, configure policies, and more.
 
 ## Prerequisites
 
-* You must have been provisioned with an enterprise on {% data variables.enterprise.data_residency_site %}.
-
 * If you intend to pay with a Microsoft Azure subscription, you must have admin access to the Azure portal or work with someone to configure an admin consent workflow. For a full list of prerequisites, see [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#prerequisites).
 
 * {% data reusables.data-residency.data-resident-enterprises-network-access %}
 
-## 1. Add users to your enterprise
+## 1. Sign up for a trial
+
+To get started with {% data variables.enterprise.data_residency_short %}, you will sign up for a trial. The trial:
+
+* Lasts for **{% data reusables.enterprise.ghec-trial-length %} days**
+* Includes access to most {% data variables.product.prodname_enterprise %} features, though not the features listed in [Features not included in the trial](/admin/overview/setting-up-a-trial-of-github-enterprise-cloud#features-not-included-in-the-trial)
+* Allows you to create up to **three new organizations**
+
+<a href="https://github.com/account/enterprises/new?ref_cta=GHEC+trial&ref_loc=get+started+with+data+residency&ref_page=docs" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Set up a trial of {% data variables.product.prodname_ghe_cloud %}</span> {% octicon "link-external" height:16 %}</a>
+
+1. Visit the trial page by clicking the link above.
+1. Select **Get started with managed users**.
+1. Under "Data hosting", use the dropdown menu to select your region for {% data variables.enterprise.data_residency_short %}.
+1. Complete the signup form. Pay close attention to the following fields:
+
+   * **Subdomain**: This will appear in your enterprise's dedicated domain. For example: `{% data variables.enterprise.data_residency_example_domain %}`.
+   * **Identity Provider**: {% data variables.product.github %} partners with certain identity providers to provide a "paved-path" experience. Check whether your identity provider is a partner and ensure you understand the requirements for other systems. See [AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users#identity-management-systems).
+   * **Admin work email**: This is where you will receive the invitation to sign in and configure the enterprise for the first time.
+
+1. Click **Create enterprise**.
+
+Your enterprise can take a few hours to be provisioned. When it's ready, you'll receive a welcome email and an invitation to reset your password, delivered to the "Admin work email" address.
+
+## 2. Add users to your enterprise
 
 Enterprises on {% data variables.enterprise.data_residency_site %} use {% data variables.product.prodname_emus %}. To create user accounts and grant access to your new enterprise on {% data variables.enterprise.data_residency_site %}, you must configure authentication and SCIM provisioning. See [AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users).
 
@@ -70,16 +92,26 @@ Using an **incognito or private browsing window**:
 
 {% data reusables.enterprise-accounts.emu-manage-org-membership %}
 
-## 2. Set up billing
+## 3. Learn about {% data variables.product.github %}'s features
+
+When you have completed the initial setup of your enterprise, you and your enterprise's members can start using {% data variables.product.github %}'s features.
+
+{% data reusables.data-residency.data-resident-enterprise-feature-availability %} Some features work differently or require additional configuration compared to the equivalent feature on {% data variables.product.prodname_dotcom_the_website %}. See [AUTOTITLE](/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency).
+
+## 4. Purchase {% data variables.product.prodname_enterprise %}
+
+You can purchase {% data variables.product.prodname_enterprise %} at any time during the trial. To do so, click the **Activate enterprise** button displayed on your enterprise account.
 
 To pay for licenses and services, you can use a credit card, PayPal, or a Microsoft Azure subscription.
 
 * To add a credit card or PayPal details, see [AUTOTITLE](/billing/managing-your-billing/managing-your-payment-and-billing-information#viewing-payment-information).
 * To link an Azure subscription, see [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#connecting-your-azure-subscription-to-your-enterprise-account).
 
-## 3. Migrate data
+## 5. Migrate data
+
+To migrate existing data to your new enterprise on {% data variables.enterprise.data_residency_site %}, you can use {% data variables.product.company_short %}'s migration tools.
 
-Optionally, to migrate existing data to your new enterprise on {% data variables.enterprise.data_residency_site %}, you can use {% data variables.product.company_short %}'s migration tools.
+Optionally, you can migrate data to {% data variables.enterprise.data_residency_site %} during your trial. However, migrated organizations will count towards the limit of three new organizations during the trial.
 
 * If you're migrating from {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.prodname_ghe_server %}, Azure DevOps, or Bitbucket Server, you can migrate source code history and metadata with {% data variables.product.prodname_importer_proper_name %}. See [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer).
 * If you're migrating from a different platform, see [AUTOTITLE](/migrations/overview/migration-paths-to-github#migrations-to-ghecom).
@@ -116,12 +148,6 @@ export TARGET_REPO="TARGET-GHE-REPOSITORY-NAME"
 gh gei migrate-repo --target-api-url $TARGET_API_URL --github-source-org $GITHUB_SOURCE_ORG --source-repo $SOURCE_REPO --github-target-org $GITHUB_TARGET_ORG --target-repo $TARGET_REPO --verbose
 ```
 
-## 4. Learn about {% data variables.product.github %}'s features
-
-When you have completed the initial setup of your enterprise, you and your enterprise's members can start using {% data variables.product.github %}'s features.
-
-{% data reusables.data-residency.data-resident-enterprise-feature-availability %} Some features work differently or require additional configuration compared to the equivalent feature on {% data variables.product.prodname_dotcom_the_website %}. See [AUTOTITLE](/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency).
-
 ## Further reading
 
 * [AUTOTITLE](/admin/data-residency/resolving-issues-with-your-enterprise-on-ghecom)

content/admin/managing-iam/understanding-iam-for-enterprises/getting-started-with-enterprise-managed-users.md

@@ -21,8 +21,7 @@ Before your developers can use {% data variables.product.prodname_ghe_cloud %} w
 
 To use {% data variables.product.prodname_emus %}, you need a **separate type of enterprise account** with {% data variables.product.prodname_emus %} enabled.
 
-* To create an enterprise on {% data variables.product.prodname_dotcom_the_website %}, start a free 30-day trial of {% data variables.product.prodname_ghe_cloud %}, and choose **Enterprise with managed users**. See [AUTOTITLE](/admin/overview/setting-up-a-trial-of-github-enterprise-cloud).
-* If you require {% data variables.enterprise.data_residency_short %}, contact {% data variables.contact.contact_enterprise_sales %}.
+You can create an enterprise account by signing up for a trial of {% data variables.product.prodname_ghe_cloud %}. See [AUTOTITLE](/admin/overview/setting-up-a-trial-of-github-enterprise-cloud).
 
 ### Understand where your enterprise is hosted
 

content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md

@@ -20,22 +20,22 @@ To set up a trial, you must be signed in to a personal account. If you don't hav
 
 <a href="https://github.com/account/enterprises/new?ref_cta=GHEC+trial&ref_loc=setting+up+a+trial+of+github+enterprise+cloud&ref_page=docs" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Set up a trial of {% data variables.product.prodname_ghe_cloud %}</span> {% octicon "link-external" height:16 %}</a>
 
->[!IMPORTANT] Your trial enterprise will be hosted in the US. If you require {% data variables.enterprise.data_residency_short %} in a specific region, contact {% data variables.contact.contact_sales_data_residency %}.
-
 {% data reusables.enterprise.enterprise-types %}
 
+{% data reusables.enterprise.emus-trial-content %}
+
 ## What is included in the trial?
 
 The trial lasts for **{% data reusables.enterprise.ghec-trial-length %} days** and includes the following features.
 
 * Access to **most** {% data variables.product.prodname_ghe_cloud %} features.
-* {% data variables.product.prodname_copilot_for_business %}
-* {% data variables.product.prodname_GH_cs_and_sp %}
+* {% data variables.product.prodname_copilot_for_business %} ({% data variables.product.prodname_dotcom_the_website %} trials only)
+* {% data variables.product.prodname_GH_cs_and_sp %} ({% data variables.product.prodname_dotcom_the_website %} trials only)
 * Access to the **new billing platform**.{% ifversion enhanced-billing-platform %} See [AUTOTITLE](/billing/using-the-new-billing-platform/about-the-new-billing-platform-for-enterprises).{% endif %}
 * An **enterprise account**, which allows you to manage multiple organizations. See [AUTOTITLE](/enterprise-cloud@latest/get-started/learning-about-github/types-of-github-accounts).
 * Up to **50 licenses** to grant access to users.
 
-Your trial **won't** include {% data variables.enterprise.data_residency_short %} on {% data variables.enterprise.data_residency_site %} or access to {% data variables.product.prodname_ghe_server %}. To test these features, contact {% data variables.contact.contact_enterprise_sales %}.
+Your trial **won't** include access to {% data variables.product.prodname_ghe_server %}. To test this, contact {% data variables.contact.contact_enterprise_sales %}.
 
 ## Features not included in the trial
 
@@ -59,6 +59,7 @@ After you set up your trial, you can explore {% data variables.product.prodname_
 
 You can create up to **three new organizations** in the trial enterprise, or transfer any number of existing organizations.
 
+* You cannot transfer organizations if you selected an {% data variables.enterprise.prodname_emu_enterprise %}.
 * You cannot transfer organizations that have free or paid {% data variables.product.prodname_marketplace %} apps. Free apps are supported for new organizations in the trial.
 * You cannot transfer organizations that are already owned by another enterprise.
 * Billing for transferred organizations is paused during the trial and any coupons are removed. To reapply a coupon, contact {% data variables.contact.contact_support_page %}.

content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md

@@ -14,7 +14,7 @@ shortTitle: Setting up a trial
 
 You can set up a trial to evaluate features that require {% data variables.product.prodname_ghe_cloud %}, such as SAML single sign-on (SSO). For a full list of available features, see our [Pricing](https://github.com/pricing) page.
 
-Your trial **won't** include {% data variables.enterprise.data_residency_short %} on {% data variables.enterprise.data_residency_site %} or access to {% data variables.product.prodname_ghe_server %}. To test these features, contact {% data variables.contact.contact_enterprise_sales %}.
+Your trial **won't** include access to {% data variables.product.prodname_ghe_server %}. To test this, contact {% data variables.contact.contact_enterprise_sales %}.
 
 To set up a trial, you must be signed in to a personal account. If you don't have a personal account, see [AUTOTITLE](/free-pro-team@latest/get-started/start-your-journey/creating-an-account-on-github).
 
@@ -23,8 +23,8 @@ To set up a trial, you must be signed in to a personal account. If you don't hav
 The trial lasts for **{% data reusables.enterprise.ghec-trial-length %} days** and includes the following features.
 
 * Access to **most** {% data variables.product.prodname_ghe_cloud %} features.
-* {% data variables.product.prodname_copilot_for_business %}
-* {% data variables.product.prodname_GH_cs_and_sp %}
+* {% data variables.product.prodname_copilot_for_business %} ({% data variables.product.prodname_dotcom_the_website %} trials only)
+* {% data variables.product.prodname_GH_cs_and_sp %} ({% data variables.product.prodname_dotcom_the_website %} trials only)
 * Access to the **new billing platform**. See [AUTOTITLE](/billing/using-the-new-billing-platform/about-the-new-billing-platform-for-enterprises).
 * An **enterprise account**, which allows you to manage multiple organizations. See [AUTOTITLE](/enterprise-cloud@latest/get-started/learning-about-github/types-of-github-accounts).
 * Up to **50 licenses** to grant access to users.
@@ -58,6 +58,8 @@ When setting up your trial of GitHub Enterprise Cloud, you'll choose an enterpri
 
 To help you decide which choice is best for your enterprise, see [AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/choosing-an-enterprise-type-for-github-enterprise-cloud).
 
+{% data reusables.enterprise.emus-trial-content %}
+
 ### Setting up {% data variables.product.prodname_ghe_cloud %}
 
 You can find full instructions on setting up {% data variables.product.prodname_ghe_cloud %} in the [AUTOTITLE](/enterprise-cloud@latest/get-started/onboarding/getting-started-with-github-enterprise-cloud) guide.

data/reusables/data-residency/when-you-adopt-data-residency.md

@@ -1,4 +1,6 @@
-When you adopt {% data variables.enterprise.data_residency %}, you can choose where your company's code and data are stored. Your enterprise will be hosted on a dedicated subdomain of {% data variables.enterprise.data_residency_site %}. Data residency makes it easy to separate open source and enterprise work, and helps you meet specific data residency compliance requirements.
+When you adopt {% data variables.enterprise.data_residency %}, you can choose where your company's code and data are stored. Your enterprise will be hosted on a dedicated subdomain of {% data variables.enterprise.data_residency_site %}.
+
+Data residency makes it easy to separate open source and enterprise work, and helps you meet specific data residency compliance requirements.
 
 The available regions are:
 

data/reusables/enterprise/about-ghec.md

@@ -1 +1 @@
-{% data variables.product.prodname_ghe_cloud %} is designed for large businesses or teams who collaborate on {% data variables.product.prodname_dotcom_the_website %}.
+{% data variables.product.prodname_ghe_cloud %} is designed for large businesses or teams who collaborate on {% data variables.product.github %}.

data/reusables/enterprise/emus-trial-content.md

@@ -0,0 +1,6 @@
+### Enterprises with managed users
+
+If you choose an {% data variables.enterprise.prodname_emu_enterprise %}, you will also choose whether to create an enterprise on {% data variables.product.prodname_dotcom_the_website %} or in a specific data residency region on {% data variables.enterprise.data_residency_site %}.
+
+* Trials on **{% data variables.product.prodname_dotcom_the_website %}** include free access to {% data variables.product.prodname_copilot_for_business %} and {% data variables.product.prodname_GHAS %} features. Your enterprise will be hosted in the US.
+* Trials on **{% data variables.enterprise.data_residency_site %}** allow you to meet specific regulatory requirements and choose a unique subdomain for your enterprise. However, the trial won't include free access to {% data variables.product.prodname_copilot_for_business %} and {% data variables.product.prodname_GHAS %} features, or access to the currently unavailable features listed in [AUTOTITLE](/enterprise-cloud@latest/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency#currently-unavailable-features).