Skip to content

Commit 5ed0543

Browse files
saritaisaritai
committed
Adding reusables for enterprise guides and trimming things in other guides
1 parent fc7ed52 commit 5ed0543

19 files changed

Lines changed: 99 additions & 97 deletions

‎content/admin/configuration/configuring-your-enterprise/initializing-github-ae.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ redirect_from:
1313

1414
Before you can initialize your enterprise, you must purchase {% data variables.product.product_name %}. For more information, contact {% data variables.contact.contact_enterprise_sales %}.
1515

16-
After you purchase {% data variables.product.product_name %}, we'll ask you to provide an email address and username for the person you want to initialize the enterprise. Your dedicated technical account manager in {% data variables.contact.enterprise_support %} will create an account for the enterprise owner and send the enterprise owner an email to log into {% data variables.product.product_name %} and complete the initialization. Make sure the information you provide matches the intended enterprise owner's information in the IdP. For more information about enterprise owners, see "[Roles in an enterprise](/github/setting-up-and-managing-your-enterprise/roles-in-an-enterprise#enterprise-owner)."
16+
{% data reusables.github-ae.initialize-enterprise %} Make sure the information you provide matches the intended enterprise owner's information in the IdP. For more information about enterprise owners, see "[Roles in an enterprise](/github/setting-up-and-managing-your-enterprise/roles-in-an-enterprise#enterprise-owner)."
1717

1818
{% note %}
1919

‎content/get-started/onboarding/getting-started-with-github-ae.md‎

Lines changed: 27 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,86 +1,80 @@
11
---
22
title: Getting started with GitHub AE
3-
intro: 'Get started with setting up and configuring {% data variables.product.prodname_ghe_managed %} for your enterprise.'
3+
intro: 'Get started with setting up and configuring {% data variables.product.product_name %} for {% data variables.product.product_location %}.'
44
versions:
55
ghae: '*'
66
---
77

88
This guide will walk you through setting up, configuring, and managing settings for {% data variables.product.product_location %} on {% data variables.product.product_name %} as an enterprise owner.
99

10-
## Part 1: Setting up {% data variables.product.prodname_ghe_managed %}
11-
To get started with {% data variables.product.prodname_ghe_managed %}, you can create your enterprise account, initialize {% data variables.product.prodname_ghe_managed %}, configure an IP allow list, configure user authentication and provisioning, and manage billing for your enterprise.
10+
## Part 1: Setting up {% data variables.product.product_name %}
11+
To get started with {% data variables.product.product_name %}, you can create your enterprise account, initialize {% data variables.product.product_name %}, configure an IP allow list, configure user authentication and provisioning, and manage billing for {% data variables.product.product_location %}.
1212

13-
### 1. Creating your {% data variables.product.prodname_ghe_managed %} enterprise account
14-
You will first need to purchase {% data variables.product.prodname_ghe_managed %}. For more information, contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact).
13+
### 1. Creating your {% data variables.product.product_name %} enterprise account
14+
You will first need to purchase {% data variables.product.product_name %}. For more information, contact [{% data variables.product.prodname_dotcom %}'s Sales team](https://enterprise.github.com/contact).
1515

16-
After you purchase {% data variables.product.prodname_ghe_managed %}, we will ask you for email address and username details for the person you want to initialize the enterprise, which will then be used by your dedicated technical account manager in {% data variables.product.prodname_dotcom %} Enterprise Support to create an account.
16+
{% data reusables.github-ae.initialize-enterprise %}
1717

18-
### 2. Initializing {% data variables.product.prodname_ghe_managed %}
19-
After {% data variables.product.company_short %} creates the owner account for your enterprise on {% data variables.product.product_name %}, you will receive an email to sign in and complete the initialization. During initialization, you, as the enterprise owner, will name your enterprise, configure SAML SSO, create policies for all organizations in your enterprise, and configure a support contact for your users. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/configuring-your-enterprise/initializing-github-ae)."
18+
### 2. Initializing {% data variables.product.product_name %}
19+
After {% data variables.product.company_short %} creates the owner account for {% data variables.product.product_location %} on {% data variables.product.product_name %}, you will receive an email to sign in and complete the initialization. During initialization, you, as the enterprise owner, will name {% data variables.product.product_location %}, configure SAML SSO, create policies for all organizations in {% data variables.product.product_location %}, and configure a support contact for your enterprise members. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/configuring-your-enterprise/initializing-github-ae)."
2020

2121
### 3. Restricting network traffic
2222
You can configure an allow list for specific IP addresses to restrict access to assets owned by organizations in your enterprise account. For more information, see "[Restricting network traffic to your enterprise](/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise)."
2323

24-
### 4. Managing identity and access for your enterprise
24+
### 4. Managing identity and access for {% data variables.product.product_location %}
2525
You can centrally manage access to {% data variables.product.product_location %} on {% data variables.product.product_name %} from an identity provider (IdP) using SAML single sign-on (SSO) for user authentication and System for Cross-domain Identity Management (SCIM) for user provisioning. Once you configure provisioning, you can assign or unassign users to the application from the IdP, creating or disabling user accounts in the enterprise. For more information, see "[About identity and access management for your enterprise](/admin/authentication/managing-identity-and-access-for-your-enterprise/about-identity-and-access-management-for-your-enterprise)."
2626

27-
### 5. Managing billing for your enterprise
28-
Owners of the subscription for your enterprise on {% data variables.product.product_name %} can view billing details for {% data variables.product.product_name %} in the Azure portal. For more information, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)."
27+
### 5. Managing billing for {% data variables.product.product_location %}
28+
Owners of the subscription for {% data variables.product.product_location %} on {% data variables.product.product_name %} can view billing details for {% data variables.product.product_name %} in the Azure portal. For more information, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)."
2929

3030
## Part 2: Organizing and managing enterprise members
31-
As an enterprise owner for {% data variables.product.prodname_ghe_managed %}, you can manage settings on user, repository, team, and organization levels. You can manage users in your enterprise, create and manage organizations, set policies for repository management, and create and manage teams.
31+
As an enterprise owner for {% data variables.product.product_name %}, you can manage settings on user, repository, team, and organization levels. You can manage members of {% data variables.product.product_location %}, create and manage organizations, set policies for repository management, and create and manage teams.
3232

33-
### 1. Managing and auditing enterprise members
34-
You can manage settings and audit activity for the members of {% data variables.product.product_location %}. You can manage dormant users, view the audit log for user activity in {% data variables.product.product_location %}, and customize messages that users will see on {% data variables.product.product_location %}. For more information, see "[Managing users in your enterprise](/admin/user-management/managing-users-in-your-enterprise)."
33+
### 1. Managing members of {% data variables.product.product_location %}
34+
{% data reusables.getting-started.managing-enterprise-members %}
3535

3636
### 2. Creating organizations
37-
You can create new organizations in your enterprise to reflect your company or group's structure. For more information, see "[Creating a new organization from scratch](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)."
37+
{% data reusables.getting-started.creating-organizations %}
3838

3939
### 3. Adding members to organizations
40-
You can add members to organizations in your enterprise as long as you are an organization owner in the organizations you want to manage. You can also configure visibility of organization membership. For more information, see "[Adding people to your organization](/organizations/managing-membership-in-your-organization/adding-people-to-your-organization)" and "[Configuring visibility for organization membership](/admin/user-management/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership)."
40+
{% data reusables.getting-started.adding-members-to-organizations %}
4141

4242
### 4. Creating teams
43-
Teams are groups of organization members that can be granted permissions to specific repositories as a group. You can create individual teams or multiple levels of nested teams in each of your organizations. For more information, see "[Creating teams](/organizations/organizing-members-into-teams/creating-a-team)" and "[Adding people to teams](/organizations/organizing-members-into-teams/adding-organization-members-to-a-team)."
43+
{% data reusables.getting-started.creating-teams %}
4444

4545
### 5. Setting organization and repository permission levels
46-
We recommend giving a limited number of members in each organization an organization owner role, which provides complete administrative access for that organization. For more information, see "[Permission levels for an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/permission-levels-for-an-organization)."
47-
48-
For organizations where you have admin permissions, you can also customize access to each repository with granular permission levels. For more information, see "[Repository permissions levels for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization)."
46+
{% data reusables.getting-started.setting-org-and-repo-permissions %}
4947

5048
### 6. Enforcing repository management policies
51-
As an enterprise owner, you can set repository management policies for all organizations in your enterprise, or allow policies to be set in each organization. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise)."
49+
{% data reusables.getting-started.enforcing-repo-management-policies %}
5250

5351
## Part 3: Building securely
5452
To increase the security of {% data variables.product.product_location %}, you can monitor {% data variables.product.product_location %} and configure security and analysis features for your organizations.
5553

56-
### 1. Monitoring your enterprise
54+
### 1. Monitoring {% data variables.product.product_location %}
5755
You can monitor {% data variables.product.product_location %} with your activity dashboard and audit logging. For more information, see "[Monitoring activity in your enterprise](/admin/user-management/monitoring-activity-in-your-enterprise)."
5856

5957
### 2. Configuring security features for your organizations
60-
You can use a variety of {% data variables.product.prodname_dotcom %} security features, including security policies, dependency graphs, secret scanning and Dependabot security and version updates, to keep the organizations in your enterprise secure. For more information, see "[Securing your organization](/code-security/getting-started/securing-your-organization)" and "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-and-analysis-settings-for-your-organization)."
58+
{% data reusables.getting-started.configuring-security-features %}
6159

6260
## Part 4: Customizing and automating work on {% data variables.product.product_location %}
63-
You can customize and automate work in organizations in your enterprise with the {% data variables.product.prodname_dotcom %} API, {% data variables.product.prodname_actions %}, and {% data variables.product.prodname_pages %}.
61+
You can customize and automate work in organizations in {% data variables.product.product_location %} with the {% data variables.product.prodname_dotcom %} API, {% data variables.product.prodname_actions %}, and {% data variables.product.prodname_pages %}.
6462

6563
### 1. Using the {% data variables.product.prodname_dotcom %} API
6664
{% data reusables.getting-started.api %}
6765

6866
### 2. Building {% data variables.product.prodname_actions %}
6967
{% data reusables.getting-started.actions %}
7068

71-
For more information on enabling and configuring {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_managed %}, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_managed %}](/admin/github-actions/using-github-actions-in-github-ae/getting-started-with-github-actions-for-github-ae)."
69+
For more information on enabling and configuring {% data variables.product.prodname_actions %} for {% data variables.product.product_name %}, see "[Getting started with {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_managed %}](/admin/github-actions/using-github-actions-in-github-ae/getting-started-with-github-actions-for-github-ae)."
7270

7371
### 3. Using {% data variables.product.prodname_pages %}
74-
{% data variables.product.prodname_pages %} is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository in your enterprise and publishes a website. You can enable or disable {% data variables.product.prodname_pages %} for your users at the organization level. For more information, see "[Configuring {% data variables.product.prodname_pages %} for your enterprise](/admin/configuration/configuring-your-enterprise/configuring-github-pages-for-your-enterprise)."
75-
76-
72+
{% data reusables.getting-started.github-pages-enterprise %}
7773
## Part 5: Using {% data variables.product.prodname_dotcom %}'s learning and support resources
78-
Your users can learn more about Git and {% data variables.product.prodname_dotcom %} with our learning resources, and you can get the support you need with {% data variables.product.prodname_dotcom %} Enterprise Support.
74+
Your enterprise members can learn more about Git and {% data variables.product.prodname_dotcom %} with our learning resources, and you can get the support you need with {% data variables.product.prodname_dotcom %} Enterprise Support.
7975

8076
### 1. Learning with {% data variables.product.prodname_learning %}
81-
Your users can learn new skills by completing fun, realistic projects in their very own {% data variables.product.prodname_dotcom %} repository with [{% data variables.product.prodname_learning %}](https://lab.github.com/). Each course is a hands-on lesson created by the {% data variables.product.prodname_dotcom %} community and taught by the friendly Learning Lab bot.
82-
83-
For more information, see "[Git and {% data variables.product.prodname_dotcom %} learning resources](/github/getting-started-with-github/quickstart/git-and-github-learning-resources)."
77+
{% data reusables.getting-started.learning-lab-enterprise %}
8478

8579
### 2. Working with {% data variables.product.prodname_dotcom %} Enterprise Support
86-
{% data variables.product.prodname_ghe_managed %} includes access to {% data variables.product.prodname_dotcom %} Enterprise Support. {% data variables.product.prodname_dotcom %} Enterprise Support can help you troubleshoot issues that come up on {% data variables.product.prodname_ghe_managed %}. For more information, see "[About {% data variables.product.prodname_dotcom %} Enterprise Support](/admin/enterprise-support/overview/about-github-enterprise-support)."
80+
{% data reusables.getting-started.contact-support-enterprise %}

0 commit comments

Comments
 (0)