Make "Upgrading GHES" scannable (#51375)

Co-authored-by: Rachael Rose Renk <[email protected]>

Author: vgrl

content/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities.md

@@ -1455,7 +1455,7 @@ ghe-upgrade UPGRADE-PACKAGE-FILENAME
 
 This utility manages scheduled installation of upgrade packages. You can show, create new, or remove scheduled installations. You must create schedules using cron expressions. For more information, see the [Cron Wikipedia entry](https://en.wikipedia.org/wiki/Cron#Overview).
 
-The `ghe-upgrade-scheduler` utility is best suited for scheduling hotpatch upgrades, which do not require maintenance mode or a reboot in most cases. This utility is not practical for full package upgrades, which require an administrator to manually set maintenance mode, reboot the instance, and unset maintenance mode. For more information about the different types of upgrades, see "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server#upgrading-with-an-upgrade-package)"
+The `ghe-upgrade-scheduler` utility is best suited for scheduling hotpatch upgrades, which do not require maintenance mode or a reboot in most cases. This utility is not practical for full package upgrades, which require an administrator to manually set maintenance mode, reboot the instance, and unset maintenance mode. For more information about the different types of upgrades, see "[AUTOTITLE](/admin/upgrading-your-instance/performing-an-upgrade/upgrading-with-an-upgrade-package)"
 
 To schedule a new installation for a package:
 

content/admin/guides.md

@@ -63,17 +63,19 @@ includeGuides:
   - /admin/administering-your-instance/administering-your-instance-from-the-web-ui
   - /admin/configuring-settings/hardening-security-for-your-enterprise/troubleshooting-tls-errors
   - /admin/configuring-settings/configuring-network-settings/using-github-enterprise-server-with-a-load-balancer
-  - /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/about-high-availability-configuration
-  - /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/accessing-the-monitor-dashboard
-  - /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/creating-a-high-availability-replica
-  - /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha
-  - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/enabling-automatic-update-checks
-  - /admin/monitoring-managing-and-updating-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance
-  - /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/recommended-alert-thresholds
-  - /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/setting-up-external-monitoring
-  - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrade-requirements
-  - /admin/monitoring-managing-and-updating-your-instance/updating-the-virtual-machine-and-physical-resources/upgrading-github-enterprise-server
-  - /admin/monitoring-managing-and-updating-your-instance/monitoring-your-instance/about-system-logs
+  - /admin/monitoring-and-managing-your-instance/configuring-high-availability/about-high-availability-configuration
+  - /admin/monitoring-and-managing-your-instance/monitoring-your-instance/accessing-the-monitor-dashboard
+  - /admin/monitoring-and-managing-your-instance/configuring-high-availability/creating-a-high-availability-replica
+  - /admin/monitoring-and-managing-your-instance/configuring-clustering/differences-between-clustering-and-high-availability-ha
+  - /admin/upgrading-your-instance/preparing-to-upgrade/enabling-automatic-update-checks
+  - /admin/monitoring-and-managing-your-instance/configuring-high-availability/initiating-a-failover-to-your-replica-appliance
+  - /admin/monitoring-and-managing-your-instance/monitoring-your-instance/recommended-alert-thresholds
+  - /admin/monitoring-and-managing-your-instance/monitoring-your-instance/setting-up-external-monitoring
+  - /admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process
+  - /admin/upgrading-your-instance/preparing-to-upgrade/upgrade-requirements
+  - /admin/upgrading-your-instance/preparing-to-upgrade/taking-a-snapshot
+  - /admin/upgrading-your-instance/performing-an-upgrade
+  - /admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs
   - /support/learning-about-github-support/about-github-support
   - /admin/managing-github-actions-for-your-enterprise/managing-access-to-actions-from-githubcom/about-using-actions-in-your-enterprise
   - /admin/managing-github-actions-for-your-enterprise/advanced-configuration-and-troubleshooting/backing-up-and-restoring-github-enterprise-server-with-github-actions-enabled

content/admin/index.md

@@ -106,10 +106,11 @@ children:
   - /administering-your-instance
   - /managing-iam
   - /managing-accounts-and-repositories
+  - /upgrading-your-instance
   - /backing-up-and-restoring-your-instance
   - /enforcing-policies
   - /monitoring-activity-in-your-enterprise
-  - /monitoring-managing-and-updating-your-instance
+  - /monitoring-and-managing-your-instance
   - /managing-github-actions-for-your-enterprise
   - /configuring-packages
   - /managing-code-security
@@ -118,4 +119,3 @@ children:
   - /release-notes
   - /all-releases
 ---
-

content/admin/monitoring-managing-and-updating-your-instance/caching-repositories/about-repository-caching.md renamed to content/admin/monitoring-and-managing-your-instance/caching-repositories/about-repository-caching.md

@@ -8,6 +8,7 @@ topics:
   - Enterprise
 redirect_from:
   - /admin/enterprise-management/caching-repositories/about-repository-caching
+  - /admin/monitoring-managing-and-updating-your-instance/caching-repositories/about-repository-caching
 ---
 
 If you have teams and CI farms located around the world, you may experience reduced performance on your primary {% data variables.product.prodname_ghe_server %} instance. While active geo-replicas can improve the performance of read requests, this comes at the cost of limiting write throughput. To reduce load on your primary instance and improve write throughput performance, you can configure a repository cache, an asynchronous read-only mirror of repositories located near these geographically-distributed clients.

content/admin/monitoring-managing-and-updating-your-instance/caching-repositories/configuring-a-repository-cache.md renamed to content/admin/monitoring-and-managing-your-instance/caching-repositories/configuring-a-repository-cache.md

@@ -8,6 +8,7 @@ topics:
   - Enterprise
 redirect_from:
   - /admin/enterprise-management/caching-repositories/configuring-a-repository-cache
+  - /admin/monitoring-managing-and-updating-your-instance/caching-repositories/configuring-a-repository-cache
 ---
 
 ## About configuration for repository caching

content/admin/monitoring-managing-and-updating-your-instance/caching-repositories/index.md renamed to content/admin/monitoring-and-managing-your-instance/caching-repositories/index.md

@@ -10,4 +10,6 @@ children:
   - /configuring-a-repository-cache
 redirect_from:
   - /admin/enterprise-management/caching-repositories
+  - /admin/monitoring-managing-and-updating-your-instance/caching-repositories
 ---
+

content/admin/monitoring-managing-and-updating-your-instance/configuring-clustering/about-cluster-nodes.md renamed to content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-cluster-nodes.md

@@ -7,6 +7,7 @@ redirect_from:
   - /enterprise/admin/enterprise-management/about-cluster-nodes
   - /admin/enterprise-management/about-cluster-nodes
   - /admin/enterprise-management/configuring-clustering/about-cluster-nodes
+  - /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/about-cluster-nodes
 versions:
   ghes: '*'
 type: overview

content/admin/monitoring-managing-and-updating-your-instance/configuring-clustering/about-clustering.md renamed to content/admin/monitoring-and-managing-your-instance/configuring-clustering/about-clustering.md

@@ -1,14 +1,15 @@
 ---
 title: About clustering
-intro: "The cluster topology for {% data variables.product.prodname_ghe_server %} is designed to support tens of thousands of users where other topologies would experience resource exhaustion. In a cluster, the instance's services scale horizontally across multiple nodes."
-product: "{% data variables.product.company_short %} determines eligibility for clustering, and must enable the configuration for your instance's license. Clustering requires careful planning and additional administrative overhead."
+intro: 'The cluster topology for {% data variables.product.prodname_ghe_server %} is designed to support tens of thousands of users where other topologies would experience resource exhaustion. In a cluster, the instance''s services scale horizontally across multiple nodes.'
+product: '{% data variables.product.company_short %} determines eligibility for clustering, and must enable the configuration for your instance''s license. Clustering requires careful planning and additional administrative overhead.'
 redirect_from:
   - /enterprise/admin/clustering/overview
   - /enterprise/admin/clustering/about-clustering
   - /enterprise/admin/clustering/clustering-overview
   - /enterprise/admin/enterprise-management/about-clustering
   - /admin/enterprise-management/about-clustering
   - /admin/enterprise-management/configuring-clustering/about-clustering
+  - /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/about-clustering
 versions:
   ghes: '*'
 type: overview

content/admin/monitoring-managing-and-updating-your-instance/configuring-clustering/cluster-network-configuration.md renamed to content/admin/monitoring-and-managing-your-instance/configuring-clustering/cluster-network-configuration.md

@@ -7,6 +7,7 @@ redirect_from:
   - /enterprise/admin/enterprise-management/cluster-network-configuration
   - /admin/enterprise-management/cluster-network-configuration
   - /admin/enterprise-management/configuring-clustering/cluster-network-configuration
+  - /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/cluster-network-configuration
 versions:
   ghes: '*'
 type: reference

content/admin/monitoring-managing-and-updating-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md renamed to content/admin/monitoring-and-managing-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster.md

@@ -4,6 +4,7 @@ intro: 'You can configure a replica of your entire {% data variables.product.pro
 redirect_from:
   - /enterprise/admin/enterprise-management/configuring-high-availability-replication-for-a-cluster
   - /admin/enterprise-management/configuring-high-availability-replication-for-a-cluster
+  - /admin/monitoring-managing-and-updating-your-instance/configuring-clustering/configuring-high-availability-replication-for-a-cluster
 versions:
   ghes: '>= 3.9'
 type: how_to