Fix broken links (theforeman#3771)

maximiliankolb · web-flow · commit 4277050b2ac5 · 2025-04-04T08:12:01.000+02:00
$ cat guides/common/modules/con_registering-hosts-by-using-global-registration.adoc | head -n 2 [id="Registering_Hosts_by_Using_Global_Registration_{context}"] = Registering hosts by using global registration * error on https://docs.theforeman.org/nightly/Managing_Hosts/index-katello.html#resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-hosts_managing-hosts * broken link: https://docs.theforeman.org/nightly/Installing_Server/index-katello.html#resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-foreman_managing-hosts * fixed link: https://docs.theforeman.org/nightly/Installing_Server/index-katello.html#resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-foreman_foreman Use xref but hide it for orcharhino affects nightly to at least 3.12
diff --git a/guides/common/modules/con_applying-errata-to-hosts.adoc b/guides/common/modules/con_applying-errata-to-hosts.adoc
@@ -9,7 +9,7 @@ ifdef::satellite[]
 For more information, see xref:Synchronizing_Repositories_{context}[].
 endif::[]
 * Register the host to an environment and content view on {ProjectServer}.
-For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 * Configure the host for remote execution.
 For more information about running remote execution jobs, see {ManagingHostsDocURL}Configuring_and_Setting_Up_Remote_Jobs_managing-hosts[Configuring and Setting Up Remote Jobs] in _{ManagingHostsDocTitle}_.
 
diff --git a/guides/common/modules/con_converting-a-host-to-rhel.adoc b/guides/common/modules/con_converting-a-host-to-rhel.adoc
@@ -64,7 +64,7 @@ ifdef::managing-hosts[]
 For more information, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
 endif::[]
 ifndef::managing-hosts[]
-For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering Hosts by Using Global Registration] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 endif::[]
 . Run the pre-conversion analysis on the host group to verify if your hosts are ready for the conversion.
 Execute a remote job with the following settings:
diff --git a/guides/common/modules/con_transport-modes-for-remote-execution.adoc b/guides/common/modules/con_transport-modes-for-remote-execution.adoc
@@ -47,5 +47,5 @@ ifndef::managing-hosts[]
 * To enable pull mode on a new host, continue with the following in _{ManagingHostsDocTitle}_:
 
 ** {ManagingHostsDocURL}Creating_a_Host_managing-hosts[Creating a Host]
-** {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts]
+** {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration]
 endif::[]
diff --git a/guides/common/modules/proc_applying-errata-to-multiple-hosts.adoc b/guides/common/modules/proc_applying-errata-to-multiple-hosts.adoc
@@ -7,7 +7,7 @@ Use these procedures to review and apply errata to multiple RHEL hosts.
 * Synchronize {ProjectName} repositories with the latest errata available from Red{nbsp}Hat.
 For more information, see xref:Synchronizing_Repositories_{context}[].
 * Register the hosts to an environment and content view on {ProjectServer}.
-For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 * Configure the host for remote execution.
 For more information about running remote execution jobs, see {ManagingHostsDocURL}Configuring_and_Setting_Up_Remote_Jobs_managing-hosts[Configuring and Setting Up Remote Jobs] in _{ManagingHostsDocTitle}_.
 
diff --git a/guides/common/modules/proc_configuring-provisioning-callback-for-a-host.adoc b/guides/common/modules/proc_configuring-provisioning-callback-for-a-host.adoc
@@ -20,7 +20,9 @@ You can add parameters to hosts or host groups to provide the credentials that t
 .Prerequisites
 
 Before you can configure provisioning callbacks, you must add {Project} as a dynamic inventory in {awx}.
-For more information, see {ManagingConfigurationsAnsibleDocURL}Integrating_{project-context}_and_{awx-context}_ansible[Integrating {Project} and {awx}].
+ifndef::orcharhino[]
+For more information, see xref:Integrating_{project-context}_and_{awx-context}_ansible[].
+endif::[]
 
 In the {awx} web UI, you must complete the following tasks:
 
diff --git a/guides/common/modules/proc_creating-a-content-view.adoc b/guides/common/modules/proc_creating-a-content-view.adoc
@@ -32,7 +32,7 @@ This can also cause errors when resolving dependencies for errata.
 
 You can view the content view on the *Content Views* page.
 To view more information about the content view, click the content view name.
-To register a host to your content view, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_.
+To register a host to your content view, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 
 [id="cli-creating-a-content-view_{context}"]
 .CLI procedure
diff --git a/guides/common/modules/proc_creating-an-activation-key-to-consume-the-content-view.adoc b/guides/common/modules/proc_creating-an-activation-key-to-consume-the-content-view.adoc
@@ -13,4 +13,4 @@ Create another activation key to assign hosts to the content view you created in
 . Click *Save*.
 
 Use your activation key to register a host to the content view.
-For more information on registering a host, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering a Host] in _{ManagingHostsDocTitle}_.
+For more information on registering a host, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
diff --git a/guides/common/modules/proc_deploying-a-virt-who-configuration-on-target-server.adoc b/guides/common/modules/proc_deploying-a-virt-who-configuration-on-target-server.adoc
@@ -14,7 +14,8 @@ ifdef::kvm-hypervisor,openstack-hypervisor,kubevirt-hypervisor[]
 endif::[]
 ifdef::vmware-el,nutanix-el,hyperv-el[]
 .Prerequisites
-* You have registered {the-target} to {ProjectServer}. For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
+* You have registered {the-target} to {ProjectServer}.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 endif::[]
 
 .Procedure
@@ -67,4 +68,4 @@ $ sh _deploy_virt_who_config_1_.sh
 ----
 $ rm _deploy_virt_who_config_1_
 ----
-endif::[]
+endif::[]
diff --git a/guides/common/modules/proc_distributing-ssh-keys-for-remote-execution.adoc b/guides/common/modules/proc_distributing-ssh-keys-for-remote-execution.adoc
@@ -13,7 +13,7 @@ Use one of the following methods to distribute the public SSH key from {SmartPro
 . xref:Using_the_{project-context}_API_to_Obtain_SSH_Keys_for_Remote_Execution_{context}[].
 . xref:Configuring_a_{client-provisioning-template-type}_Template_to_Distribute_SSH_Keys_During_Provisioning_{context}[].
 . For new {Project} hosts, you can deploy SSH keys to {Project} hosts during registration using the global registration template.
-For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering a Host to {ProjectName} Using the Global Registration Template] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 
 {Project} distributes SSH keys for the remote execution feature to the hosts provisioned from {Project} by default.
 
diff --git a/guides/common/modules/proc_installing-and-configuring-puppet-agent-during-host-registration.adoc b/guides/common/modules/proc_installing-and-configuring-puppet-agent-during-host-registration.adoc
@@ -81,7 +81,7 @@ ifeval::[{context} == "managing-hosts"]
 For more information, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
 endif::[]
 ifeval::[{context} != "managing-hosts"]
-For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 endif::[]
 . Navigate to *Infrastructure* > *{SmartProxies}*.
 . From the list in the *Actions* column for the required {SmartProxyServer}, select *Certificates*.
diff --git a/guides/common/modules/proc_installing-standalone-hammer.adoc b/guides/common/modules/proc_installing-standalone-hammer.adoc
@@ -92,6 +92,6 @@ endif::[]
 ifdef::katello,orcharhino,satellite[]
 .Additional resources
 * {ManagingHostsDocURL}Enabling_Custom_Repositories_on_Content_Hosts_managing-hosts[Enabling repositories on hosts] in _{ManagingHostsDocTitle}_
-* {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_
+* {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_
 * {ContentManagementDocURL}Synchronizing_Repositories_content-management[Synchronizing Repositories] in _{ContentManagementDocTitle}_
 endif::[]
diff --git a/guides/common/modules/proc_promoting-a-content-view.adoc b/guides/common/modules/proc_promoting-a-content-view.adoc
@@ -74,4 +74,4 @@ $ hammer content-view version info --id _My_Content_View_Version_ID_
 ----
 
 .Next steps
-* To register a host to your content view, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_.
+* To register a host to your content view, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
diff --git a/guides/common/modules/proc_renaming-server.adoc b/guides/common/modules/proc_renaming-server.adoc
@@ -50,7 +50,7 @@ ifndef::orcharhino[]
 For more information about installing a custom SSL certificate, see {InstallingServerDocURL}Deploying_a_Custom_SSL_Certificate_to_Server_{project-context}[Deploying a Custom SSL Certificate to {ProjectServer}] in _{InstallingServerDocTitle}_.
 endif::[]
 . Reregister all hosts and {SmartProxyServers} that are registered to {ProjectServer}.
-For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering Hosts] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 . On all {SmartProxyServers}, run the {Project} installation script to update references to the new host name:
 +
 [options="nowrap", subs="+quotes,verbatim,attributes"]
diff --git a/guides/common/modules/ref_best-practices-for-patching-content-hosts.adoc b/guides/common/modules/ref_best-practices-for-patching-content-hosts.adoc
@@ -2,7 +2,7 @@
 = Best practices for patching content hosts
 
 * Registering hosts to {Project} requires {project-client-name}, which contains the `katello-host-tools` package and its dependencies.
-For more information, see {ManagingHostsDocURL}Registering_Hosts_managing-hosts[Registering hosts] in _{ManagingHostsDocTitle}_.
+For more information, see {ManagingHostsDocURL}Registering_Hosts_by_Using_Global_Registration_managing-hosts[Registering hosts by using global registration] in _{ManagingHostsDocTitle}_.
 * Use the {ProjectWebUI} to install, upgrade, and remove packages from hosts.
 You can update content hosts with job templates using SSH and Ansible.
 * Apply errata on content hosts using the {ProjectWebUI}.
diff --git a/guides/common/modules/ref_resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-hosts.adoc b/guides/common/modules/ref_resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-hosts.adoc
@@ -5,5 +5,5 @@ To reset the {customssl} certificate on your hosts to default self-signed certif
 For more information, see xref:Registering_Hosts_by_Using_Global_Registration_{context}[].
 
 .Additional resources
-* {InstallingServerDocURL}resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-{project-context}_{context}[Resetting {customssl} certificate to default self-signed certificate on {ProjectServer}] in _{InstallingServerDocTitle}_.
+* {InstallingServerDocURL}resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-{project-context}_{project-context}[Resetting {customssl} certificate to default self-signed certificate on {ProjectServer}] in _{InstallingServerDocTitle}_.
 * {InstallingSmartProxyDocURL}resetting-custom-ssl-certificate-to-default-self-signed-certificate-on-{smart-proxy-context}_{smart-proxy-context}[Resetting {customssl} certificate to default self-signed certificate on {SmartProxyServer}] in _{InstallingSmartProxyDocTitle}_.
