reverted section IDs

Author: tbazant

articles/AI.asm.xml

@@ -256,7 +256,7 @@
   </structure>
   <structure renderas="article" xml:id="ai-deployment-intro" xml:lang="en">
     <merge>
-      <title>Installing &productname;</title>
+      <title>Deploying and Installing &productname;</title>
       <revhistory xml:id="rh-deployment-intro">
         <revision><date>2024-09-04</date>
           <revdescription>
@@ -323,7 +323,7 @@
           </varlistentry>
         </variablelist>
         <para>
-          &productname; is a complex product consisting of multiple software
+          &productname; is a versatile product consisting of multiple software
           layers and components. This document outlines the complete workflow
           for deploying and installing all &productname; dependencies, as well
           as &productname; itself. You can also find references to recommended
@@ -350,7 +350,7 @@
         <title>Installing &ailibrary;</title>
         <abstract>
           <para>
-            &productname; is being delivered as a set of components that you can
+            &productname; is delivered as a set of components that you can
             combine to meet specific use cases. This provides extraordinary
             flexibility but means that there is not a single &helm; chart that
             installs the whole stack. To enable the full integrated stack, you
@@ -655,7 +655,10 @@ paths. SL Micro if immutability is wanted -->
 
 <!-- TODO AI: Support for Various Environments: the documentation should reflect
 support for various Kubernetes clusters and operating systems, not just SUSE's,
-while emphasizing preferred configurations. -->
+while emphasizing preferred configurations. Link to the supported OSes
+for RKE2 matrix as well:
+https://www.suse.com/suse-rancher/support-matrix/all-supported-versions/rancher-v2-10-4/
+-->
 
 <!-- TODO AI: Ensure consistency in terminology and aligning it with product
   marketing messaging -->

concepts/AI-intro-how-works.xml

@@ -18,7 +18,7 @@
     <meta name="maintainer" content="tbazant@suse.com" its:translate="no"/>
     <abstract>
       <para>
-        &productname; is a cluster-oriented solution and consists of multiple
+        &productname; is a cloud native solution that comprises multiple
         software building blocks. These blocks include the Linux operating
         system running on bare metal or virtualized, &kube; cluster with a Web
         UI management layer, supportive tools to utilize GPU capabilities, and

snippets/ai-library-requirement.xml

@@ -11,6 +11,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink">
   <para>
     Before the installation, you need to get user access to the &sappco;, create
     a &kube; namespace, and log in to the &helm; registry as described in
-    <xref linkend="ai-deployment-ailibrary-installing"/>.
+    <xref linkend="suse-ai-deploy-suse-ai"/>.
   </para>
 </tip>

tasks/AI-deployment-ailibrary-installing.xml

@@ -6,7 +6,7 @@
   <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
     %entities;
 ]>
-<topic xml:id="ai-deployment-ailibrary-installing"
+<topic xml:id="suse-ai-deploy-suse-ai"
  role="concept" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"

tasks/AI-deployment-cluster-preparation.xml

@@ -6,7 +6,7 @@
   <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
     %entities;
 ]>
-<topic xml:id="ai-cluster-preparation"
+<topic xml:id="suse-ai-deploy-prepare"
  role="concept" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"

tasks/AI-deployment-kube-installing.xml

@@ -22,7 +22,7 @@
         &kube; distribution for users who start deploying on cluster nodes from
         scratch. If you already have a &kube; cluster installed and running, you
         can skip this procedure and continue with
-        <xref linkend="ai-cluster-preparation"/>.
+        <xref linkend="suse-ai-deploy-suse-ai"/>.
       </para>
     </abstract>
   </info>

tasks/AI-deployment-steps-after.xml

@@ -6,7 +6,7 @@
   <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
     %entities;
 ]>
-<topic xml:id="ai-deployment-steps-afterward"
+<topic xml:id="suse-ai-deploy-post"
  role="concept" xml:lang="en"
  xmlns="http://docbook.org/ns/docbook" version="5.2"
  xmlns:its="http://www.w3.org/2005/11/its"
@@ -18,8 +18,8 @@
     <meta name="maintainer" content="tbazant@suse.com" its:translate="no"/>
     <abstract>
       <para>
-        This procedure lists tasks to accomplish after the &productname;
-        installation is complete.
+        Once the &productname; installation is finished, follow these tasks to
+        complete the initial setup and configuration.
       </para>
     </abstract>
   </info>
@@ -57,7 +57,7 @@
     </step>
     <step>
       <para>
-        Configure <emphasis>retrieval-augmented generation</emphasis>(RAG) to
+        Configure <emphasis>retrieval-augmented generation</emphasis> (RAG) to
         let the model process content relevant to the customer.
       </para>
     </step>