Merge branch 'main' into hccdoc-2089

docs/quickstarts/insights-tasks-pre-conversion/insights-tasks-pre-conversion.yml

@@ -15,24 +15,22 @@ spec:
   description: |-
     Generate a pre-conversion analysis report that summarizes potential problems and suggests recommended solutions to help you convert to RHEL. 
   introduction: |-
-    [Red Hat Insights can be used only to run the pre-conversion analysis on CentOS Linux 7 systems.]{{admonition important}}   
+    [Red Hat Insights can be used only to run the pre-conversion analysis on CentOS Linux 7 systems.]{{admonition note}}   
            
     In this quick start, you will connect and run a pre-conversion analysis on CentOS Linux machines on the Red Hat Hybrid Cloud Console. The task generates a report that summarizes potential problems and suggests recommended solutions to help you convert to RHEL.
     <br>
     <br>
     Additional information:
 
+    - Before running the pre-conversion analysis by using Red Hat Insights and performing the conversion, you must first complete all necessary [preparation steps.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/converting-using-insights_converting-from-a-linux-distribution-to-rhel)
+
     - It is possible to convert systems from other Linux distributions. [View supported conversion paths.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/con_supported-conversion-paths_converting-from-a-linux-distribution-to-rhel)
 
     - Depending on your requirements, you can convert to RHEL using a number of supported methods. [View supported conversion methods.](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/conversion-methods_converting-from-a-linux-distribution-to-rhel)
-    
-    - [Explore additional conversion considerations](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/con_planning-a-rhel-conversion_converting-from-a-linux-distribution-to-rhel) when planning your RHEL conversion.
   tasks:
     - title: Verify CentOS Linux machines are connected
       description: |-
-        [The only Red Hat Insights service you can use with registered CentOS Linux systems is the RHEL conversion. All other Insights services are available only after the conversion to RHEL.]{{admonition note}} 
-
-        Before running the pre-conversion analysis in Red Hat Insights, you must connect your CentOS machines to Insights<br>  
+        Before running the pre-conversion analysis in Red Hat Insights, you must connect your CentOS systems to Insights<br>  
         
         **To verify CentOS Linux machines are connected:**
 
@@ -64,7 +62,9 @@ spec:
         1. Log in to the [Red Hat Hybrid Cloud Console](http://console.redhat.com) and go to **Red Hat Insights > RHEL > Inventory > Systems.**
   
         1. Verify that your CentOS Linux systems appear as expected.
-
+
+        [The only Red Hat Insights service you can use with registered CentOS Linux systems is the RHEL conversion. All other Insights services are available only after the conversion to RHEL.]{{admonition note}} 
+
       # optional - the task's Check your work module
       review:
         instructions: |-
@@ -78,15 +78,16 @@ spec:
     - title: Review the pre-conversion analysis report using Insights
       description: |-
         [Back up your systems and verify that you can restore your systems if needed]{{admonition important}}
+        
         To assess whether your CentOS Linux systems can be converted to RHEL, run the Pre-conversion analysis for converting to RHEL task. The pre-conversion analysis generates a report summarizing potential problems and recommending solutions. The report also helps you decide whether it is possible or advisable to convert to RHEL.<br>       
         
         **Run a Pre-Conversion analysis:**
 
         1. Log in to the Red Hat Hybrid Cloud Console and go to **Red Hat Insights > RHEL > Automation toolkit > Tasks.**
       
-        1. Locate the **Pre-conversion analysis for converting to RHEL** task and click **Run task.**
+        1. Locate the **Pre-conversion analysis for converting to RHEL** task and click **Select systems.**
 
-        1. Select the CentOS Linux 7 systems you want to analyze for conversion and click **Execute task.**
+        1. Select the CentOS Linux 7 systems you want to analyze for conversion and click **Run task.**
           <details>
             <summary><span style="color:#0066CC">&nbsp**Don't see your system?**</span></summary>
             <br>
@@ -123,16 +124,19 @@ spec:
              
           </details>
  
-        1. The pre-conversion analysis utility generates a new report in the **Activity tab**. Click the report to view a summary of issues found in each system. 
+        [The pre-conversion process can take up to an hour to complete.]{{admonition note}}
+
+        1. The pre-conversion analysis utility generates a new report in the **Activity tab**. Select the report to view a summary of issues found in each system. 
 
         1. After task completion, you can drill down further by selecting a system to view each issue and, when applicable, a potential remediation in detail.<br>
         <br>
         Each issue is assigned a severity level:         
-              - **Inhibitor:** This would cause the conversion to fail because it will likely result in a deteriorated system state. This issue must be resolved before converting.
-              - **Overridable inhibitor**: This would cause the conversion to fail because it will likely result in a deteriorated system state. This issue must be resolved or manually overridden before converting.
-              Skipped: The test could not run because of a prerequisite test failing. This issue could cause the conversion to fail.
-              - **Warning:** This would not cause the conversion to fail. System and application issues might occur after the conversion.
+              - **Inhibitor:** Would cause the conversion to fail because it is very likely to result in a deteriorated system state. This issue must be resolved before converting.
+              - **Overridable inhibitor**: Would cause the conversion to fail because it is very likely to result in a deteriorated system state. This issue must be resolved or manually overridden before converting.
+              Skipped:  Could not run this test because of a prerequisite test failing. Could cause the conversion to fail.
+              - **Warning:** Would not cause the conversion to fail. System and application issues might occur after the conversion.
               - **Info:** Informational with no expected impact to the system or applications.
+              - **Ready for conversion:** No issues were found.
 
           <details>
             <summary><span style="color:#0066CC">&nbsp**Why did the Pre-conversion analysis task fail to complete?**</span></summary>
@@ -161,10 +165,7 @@ spec:
 
         1. After reviewing the report and resolving all reported issues, click **Run task again** to rerun the analysis and confirm that no issues are outstanding.
 
-        1. Perform the conversion to RHEL in the command-line interface. See [Converting a RHEL system](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/converting_from_an_rpm-based_linux_distribution_to_rhel/proc_converting-to-a-rhel-system_converting-from-a-linux-distribution-to-rhel) for more information.   
-
-        [It is not currently possible to perform the conversion to RHEL using Red Hat Insights.]{{admonition note}}                
-
+        1. Perform the conversion to RHEL with the Convert to RHEL from CentOS Linux 7 task or in the command-line interface. See [converting from an RPM-based Linux distrbution to RHEL](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/converting_from_an_rpm-based_linux_distribution_to_rhel/index) for more information.                               
       # optional - the task's Check your work module
       review:
         instructions: |-

docs/quickstarts/subs-create-activation-key/subs-create-activation-key.yaml

@@ -12,5 +12,5 @@ spec:
   icon: ~
   description: Create or manage an activation key to register your systems with Red Hat hosted services.
   link:
-    href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/creating_and_managing_activation_keys_on_the_hybrid_cloud_console
+    href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/getting_started_with_activation_keys_on_the_hybrid_cloud_console
     text: View documentation

docs/quickstarts/subs-getting-started/subs-getting-started.yaml

@@ -12,5 +12,5 @@ spec:
   icon: ~
   description: Review current and historical subscription usage against total capacity with the subscriptions service.
   link:
-    href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/getting_started_with_the_subscriptions_service
+    href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/getting_started_with_the_subscriptions_service
     text: View documentation

docs/quickstarts/subs-simple-content-access/subs-simple-content-access.yaml

@@ -12,5 +12,5 @@ spec:
   icon: ~
   description: Streamline your subscription workflow by enabling simple content access.
   link:
-    href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/getting_started_with_simple_content_access
+    href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/getting_started_with_simple_content_access
     text: View documentation

docs/quickstarts/subs-view-inventory/subs-view-inventory.yaml

@@ -12,5 +12,5 @@ spec:
   icon: ~
   description: View details and status information about each subscription in your inventory.
   link:
-    href: https://access.redhat.com/documentation/en-us/subscription_central/2023/html/viewing_and_managing_your_subscription_inventory_on_the_hybrid_cloud_console
+    href: https://access.redhat.com/documentation/en-us/subscription_central/1-latest/html/viewing_and_managing_your_subscription_inventory_on_the_hybrid_cloud_console
     text: View documentation