admin.yml

get_started_with_github_ae:
  title: Get started with {% data variables.product.prodname_ghe_managed %}
  description: >-
    Learn about {% data variables.product.prodname_ghe_managed %} and complete
    the initial configuration of a new enterprise.
  versions:
    ghae: '*'
  guides:
    - /admin/overview/about-github-ae
    - /admin/overview/about-data-residency
    - /admin/configuration/configuring-your-enterprise/deploying-github-ae
    - /admin/configuration/configuring-your-enterprise/initializing-github-ae
    - >-
      /admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-ae
deploy_an_instance:
  title: Deploy an instance
  description: >-
    Install {% data variables.product.prodname_ghe_server %} on your platform of
    choice and configure SAML authentication.
  versions:
    ghes: '*'
  guides:
    - /admin/overview/system-overview
    - /admin/installation
    - >-
      /admin/configuration/administering-your-instance-from-the-management-console
    - /admin/configuration/configuring-network-settings/configuring-a-hostname
    - /admin/identity-and-access-management/using-saml-for-enterprise-iam
    - /admin/configuration/configuring-your-enterprise/site-admin-dashboard
upgrade_your_instance:
  title: Upgrade your instance
  description: >-
    Test upgrades in staging, notify users of maintenance, and upgrade your
    instance for the latest features and security updates.
  versions:
    ghes: '*'
  guides:
    - >-
      /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/enabling-automatic-update-checks
    - >-
      /admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance
    - >-
      /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrade-requirements
    - >-
      /admin/user-management/managing-users-in-your-enterprise/customizing-user-messages-for-your-enterprise
    - >-
      /admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode
    - >-
      /admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server
adopting_github_actions_for_your_enterprise_ghec:
  title: Adopt GitHub Actions for your enterprise
  description: >-
    Learn how to plan and implement a rollout of {% data
    variables.product.prodname_actions %} in your enterprise.
  versions:
    ghec: '*'
  guides:
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises
    - /actions/learn-github-actions/understanding-github-actions
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud
    - /actions/security-guides/security-hardening-for-github-actions
    - >-
      /billing/managing-billing-for-github-actions/about-billing-for-github-actions
adopting_github_actions_for_your_enterprise_ghes_and_ghae:
  title: Adopt GitHub Actions for your enterprise
  description: >-
    Learn how to plan and implement a rollout of {% data
    variables.product.prodname_actions %} in your enterprise.
  versions:
    ghes: '*'
    ghae: '*'
  guides:
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises
    - /actions/learn-github-actions/understanding-github-actions
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-cloud
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise
    - /actions/security-guides/security-hardening-for-github-actions
    - >-
      /billing/managing-billing-for-github-actions/about-billing-for-github-actions
increase_fault_tolerance:
  title: Increase the fault tolerance of your instance
  description: >-
    Back up your developers' code and configure high availability (HA) to ensure
    the reliability of {% data variables.product.prodname_ghe_server %} in your
    environment.
  versions:
    ghes: '*'
  guides:
    - >-
      /admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh
    - >-
      /admin/configuration/configuring-your-enterprise/configuring-backups-on-your-appliance
    - >-
      /admin/enterprise-management/configuring-high-availability/about-high-availability-configuration
    - >-
      /admin/enterprise-management/configuring-high-availability/creating-a-high-availability-replica
    - >-
      /admin/configuration/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer
improve_security_of_your_instance:
  title: Improve the security of your instance
  description: >-
    Review network configuration and security features, and harden the instance
    running {% data variables.product.prodname_ghe_server %} to protect your
    enterprise's data.
  versions:
    ghes: '*'
  guides:
    - /admin/configuration/configuring-your-enterprise/enabling-private-mode
    - /admin/configuration/configuring-network-settings/configuring-tls
    - >-
      /admin/configuration/configuring-your-enterprise/troubleshooting-tls-errors
    - >-
      /admin/configuration/configuring-network-settings/enabling-subdomain-isolation
    - >-
      /admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh
    - /admin/configuration/configuring-network-settings/network-ports
    - >-
      /admin/configuration/configuring-network-settings/configuring-built-in-firewall-rules
    - >-
      /admin/user-management/managing-users-in-your-enterprise/best-practices-for-user-security
    - >-
      /admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator
configure_github_actions:
  title: Configure {% data variables.product.prodname_actions %}
  description: >-
    Allow your developers to create, automate, customize, and execute powerful
    software development workflows for {% data
    variables.location.product_location %} with {% data
    variables.product.prodname_actions %}.
  versions:
    ghes: '*'
  guides:
    - >-
      /admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server
    - >-
      /admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise
    - >-
      /admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect
    - >-
      /admin/github-actions/advanced-configuration-and-troubleshooting/high-availability-for-github-actions
    - >-
      /admin/github-actions/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled
    - >-
      /admin/github-actions/advanced-configuration-and-troubleshooting/using-a-staging-environment
configure_github_advanced_security:
  title: Configure {% data variables.product.prodname_GH_advanced_security %}
  description: >-
    Improve the quality and security of your developers' code with {% data
    variables.product.prodname_GH_advanced_security %}.
  versions:
    ghes: '*'
  guides:
    - >-
      /billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security
    - >-
      /admin/code-security/managing-github-advanced-security-for-your-enterprise/enabling-github-advanced-security-for-your-enterprise
    - >-
      /admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-code-scanning-for-your-appliance
    - >-
      /admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-dependency-review-for-your-appliance
    - >-
      /admin/code-security/managing-github-advanced-security-for-your-enterprise/configuring-secret-scanning-for-your-appliance
    - >-
      /admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise
get_started_with_your_enterprise_account:
  title: Get started with your enterprise account
  description: >-
    Get started with your enterprise account to centrally manage multiple
    organizations on {% data variables.product.product_name %}.
  versions:
    ghes: '*'
    ghec: '*'
  guides:
    - /admin/overview/about-enterprise-accounts
    - >-
      /billing/managing-the-plan-for-your-github-account/about-billing-for-your-enterprise
    - >-
      /admin/user-management/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise
    - >-
      /admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise
    - >-
      /admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise
    - >-
      /admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies