Merge pull request #77947 from amolnar-rh/TELCODOCS-1707-readd-xrefs

TELCODOCS-1707: Add xrefs

Author: stevsmit

edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.adoc

@@ -13,15 +13,18 @@ You update this CR to specify the image repository of the seed image and to move
 
 include::modules/cnf-image-based-upgrade-prep.adoc[leveloffset=+1]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.adoc#ztp-image-based-upgrade-creating-backup-resources-with-ztp_ztp-gitops[Creating ConfigMap objects for the image-based upgrade with Lifecycle Agent]
-////
+* xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.adoc#cnf-image-based-upgrade-prep-resources[Creating ConfigMap objects for the image-based upgrade with Lifecycle Agent]
 
 include::modules/cnf-image-based-upgrade-with-backup.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.adoc#ztp-image-based-upgrade-rollback_cnf-image-based-upgrade[(Optional) Moving to the Rollback stage of the image-based upgrade with Lifecycle Agent]
+
 include::modules/cnf-image-based-upgrade-rollback.adoc[leveloffset=+1]
 
 include::modules/cnf-image-based-upgrade-troubleshooting.adoc[leveloffset=+1]

edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc

@@ -69,7 +69,6 @@ spec:
 
 include::modules/cnf-image-based-upgrade.adoc[leveloffset=+1]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
@@ -80,7 +79,6 @@ include::modules/cnf-image-based-upgrade.adoc[leveloffset=+1]
 * xref:../../edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.adoc#ztp-image-based-upgrade-rollback_cnf-image-based-upgrade[(Optional) Moving to the Rollback stage of the image-based upgrade with Lifecycle Agent]
 
 * xref:../../edge_computing/image_based_upgrade/ztp-image-based-upgrade.adoc#ztp-image-based-upgrade-with-talm-rollback_ztp-image-based-upgrade[(Optional) Moving to the Rollback stage of the image-based upgrade with Lifecycle Agent and GitOps ZTP]
-////
 
 include::modules/cnf-image-based-upgrade-guidelines.adoc[leveloffset=+1]
 
@@ -95,7 +93,6 @@ include::modules/ztp-image-based-upgrade-hub-cluster-guide.adoc[leveloffset=+2]
 
 include::modules/ztp-image-based-upgrade-seed-image-guide.adoc[leveloffset=+2]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
@@ -104,13 +101,11 @@ include::modules/ztp-image-based-upgrade-seed-image-guide.adoc[leveloffset=+2]
 * xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#ztp-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots when using GitOps ZTP]
 
 * xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.adoc#ztp-image-based-seed-image-config_generate-seed[Seed image configuration]
-////
 
 include::modules/ztp-image-based-upgrade-backup-guide.adoc[leveloffset=+2]
 
 include::modules/ztp-image-based-upgrade-extra-manifests-guide.adoc[leveloffset=+2]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
@@ -122,7 +117,6 @@ include::modules/ztp-image-based-upgrade-extra-manifests-guide.adoc[leveloffset=
 
 * xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.adoc#cnf-image-based-upgrade-creating-backup-oadp-resources_nongitops[Creating ConfigMap objects for the image-based upgrade with Lifecycle Agent]
 
-* xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.adoc#ztp-image-based-upgrade-creating-backup-resources-with-ztp_ztp-gitops[Creating ConfigMap objects for the image-based upgrade with GitOps ZTP]
+* xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.adoc#ztp-image-based-upgrade-prep-resources[Creating ConfigMap objects for the image-based upgrade with GitOps ZTP]
 
-* xref:../../backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc#about-installing-oadp[About installing OADP]
-////
+* xref:../../backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc#about-installing-oadp[About installing OADP]

edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.adoc

@@ -15,11 +15,9 @@ include::modules/cnf-image-based-upgrade-seed-image-config.adoc[leveloffset=+1]
 
 include::modules/cnf-image-based-upgrade-generate-seed-image.adoc[leveloffset=+1]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image##cnf-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots]
+* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#cnf-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots]
 
-* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image#ztp-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots when using GitOps ZTP]
-////
+* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image#ztp-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots when using GitOps ZTP]

edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators.adoc

@@ -10,7 +10,6 @@ Prepare your clusters for the upgrade by installing the {lcao} and the OADP Oper
 
 To install the OADP Operator with the non-GitOps method, see "Installing the OADP Operator".
 
-////
 [role="_additional-resources"]
 .Additional resources
 
@@ -21,7 +20,6 @@ To install the OADP Operator with the non-GitOps method, see "Installing the OAD
 * xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-creating-backup-cr.adoc#oadp-creating-backup-cr-doc[Creating a Backup CR]
 
 * xref:../../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/restoring-applications.adoc#oadp-creating-restore-cr_restoring-applications[Creating a Restore CR]
-////
 
 include::modules/cnf-image-based-upgrade-installing-lifecycle-agent-using-cli.adoc[leveloffset=+1]
 

edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.adoc

@@ -10,19 +10,20 @@ The {lcao} needs all your OADP resources, extra manifests, and custom catalog so
 
 include::modules/cnf-image-based-upgrade-prep-oadp.adoc[leveloffset=+1]
 
-include::modules/cnf-image-based-upgrade-prep-extramanifests.adoc[leveloffset=+1]
-
-include::modules/cnf-image-based-upgrade-prep-catalogsource.adoc[leveloffset=+1]
-
-////
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#cnf-image-based-upgrade-shared-varlibcontainers[Configuring a shared container directory for the image-based upgrade]
+* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#cnf-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots]
 
 * xref:../../../backup_and_restore/application_backup_and_restore/installing/about-installing-oadp.adoc[About installing OADP]
 
-* xref:../../../edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.adoc#cnf-image-based-upgrade-for-sno[Performing an image-based upgrade with Lifecycle Agent]
+include::modules/cnf-image-based-upgrade-prep-extramanifests.adoc[leveloffset=+1]
+
+include::modules/cnf-image-based-upgrade-prep-catalogsource.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
 
 * xref:../../../operators/understanding/olm/olm-understanding-olm.adoc#olm-catalogsource_olm-understanding-olm[Catalog source]
-////
+
+* xref:../../../edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.adoc#cnf-image-based-upgrade-for-sno[Performing an image-based upgrade with Lifecycle Agent]

edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc

@@ -11,6 +11,6 @@ You can do this at install time.
 
 :FeatureName: The Lifecycle Agent
 
-include::modules/cnf-image-based-upgrade-share-container-directory.adoc[leveloffset=+1]
+include::modules/cnf-image-based-upgrade-shared-container-directory.adoc[leveloffset=+1]
 
-include::modules/ztp-image-based-upgrade-share-container-directory.adoc[leveloffset=+1]
+include::modules/ztp-image-based-upgrade-shared-container-directory.adoc[leveloffset=+1]

edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.adoc

@@ -10,16 +10,18 @@ Create your OADP resources, extra manifests, and custom catalog sources wrapped
 
 include::modules/ztp-image-based-upgrade-prep-oadp.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#ztp-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots when using GitOps ZTP]
+
+* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators#ztp-image-based-upgrade-installing-oadp-with-gitops_install-operators[Installing and configuring the OADP Operator with GitOps ZTP]
 
 include::modules/ztp-image-based-upgrade-prep-label-extramanifests.adoc[leveloffset=+1]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
 * xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#ztp-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots when using GitOps ZTP]
 
-* xref:../../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators#zp-image-based-upgrade-installing-oadp-with-gitops_install-operators[Installing and configuring the OADP Operator with GitOps ZTP]
-
-* xref:../../../edge_computing/image_based_upgrade/ztp-image-based-upgrade.adoc#ztp-image-based-upgrade-for-sno[Performing an image-based upgrade with Lifecycle Agent and GitOps ZTP]
-////
+* xref:../../../edge_computing/image_based_upgrade/ztp-image-based-upgrade.adoc#ztp-image-based-upgrade-for-sno[Performing an image-based upgrade for {sno} clusters using GitOps ZTP]

edge_computing/image_based_upgrade/ztp-image-based-upgrade.adoc

@@ -15,25 +15,28 @@ You update this CR to specify the image repository of the seed image and to move
 
 include::modules/ztp-image-based-upgrade-talm-prep.adoc[leveloffset=+1]
 
-////
 [role="_additional-resources"]
 .Additional resources
 
 * xref:../../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository-ver-ind_ztp-preparing-the-hub-cluster[Preparing the GitOps ZTP site configuration repository for version independence]
 
-* xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.adoc[Preparing for the image-based upgrade for single-node OpenShift clusters]
+* xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.adoc#ztp-image-based-upgrade-prep-resources[Creating ConfigMap objects for the image-based upgrade with Lifecycle Agent using GitOps ZTP]
 
 * xref:../../edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-image.adoc#ztp-image-based-upgrade-shared-container-directory_shared-container-directory[Configuring a shared container directory between ostree stateroots when using GitOps ZTP]
 
 * xref:../../backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc#oadp-about-backup-snapshot-locations_installing-oadp-ocs[About backup and snapshot locations and their secrets]
 
-* xref:../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-creating-backup-cr.adoc[Creating a Backup CR]
+* xref:../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-creating-backup-cr.adoc#oadp-creating-backup-cr-doc[Creating a Backup CR]
 
 * xref:../../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/restoring-applications.adoc#oadp-creating-restore-cr_restoring-applications[Creating a Restore CR]
-////
 
 include::modules/ztp-image-based-upgrade-talm-upgrade.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../edge_computing/image_based_upgrade/ztp-image-based-upgrade.adoc#ztp-image-based-upgrade-with-talm-rollback_ztp-image-based-upgrade[(Optional) Moving to the Rollback stage of the image-based upgrade with Lifecycle Agent and {ztp}]
+
 include::modules/ztp-image-based-upgrade-talm-rollback.adoc[leveloffset=+1]
 
 include::modules/cnf-image-based-upgrade-troubleshooting.adoc[leveloffset=+1]