Add SUMA guide and clarify subscriptions (SLL9) (#37)

* Add SUMA guide and clarify subscriptions

jsc#DOCTEAM-1621

* Small fixes

DC-quickstart

@@ -1,5 +1,5 @@
 #
-# DC file for SUSE Liberty Linux
+# DC file for SUSE Liberty Linux with RMT
 #
 MAIN="art-quickstart.xml"
 ROOTID="art-quickstart"

DC-suma-quickstart

@@ -0,0 +1,12 @@
+#
+# DC file for SUSE Liberty Linux with SUSE Manager
+#
+MAIN="art-suma-quickstart.xml"
+ROOTID="art-suma-quickstart"
+
+PROFCONDITION="suse-product"
+#PROFCONDITION="suse-product;beta"
+#PROFCONDITION="community-project"
+
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"

xml/art-quickstart.xml

@@ -15,14 +15,19 @@
  xmlns:xlink="http://www.w3.org/1999/xlink">
 
  <info>
-  <title>Registering &rhla; &productnumber; with RMT</title>
+  <title>Registering &rhla; &productnumber; with &rmt;</title>
   <productname>&productname;</productname>
   <productname role="abbrev">&productnameshort;</productname>
   <date><?dbtimestamp format="B d, Y"?></date>
   <xi:include href="common_copyright_gfdl.xml"/>
   <abstract>
    <para>
-    This guide describes how to use &productname; to update &rhel;&nbsp;&productnumber;.
+    This guide explains how to register and update &rhla;&nbsp;&productnumber; with &rmtool; (&rmt;).
+   </para>
+   <para>
+    To register with &suma;, see
+    <link xlink:href="https://documentation.suse.com/liberty/9/html/suma-quickstart/art-suma-quickstart.html">
+    <citetitle>Registering &rhla; &productnumber; with &suma;</citetitle></link>.
    </para>
   </abstract>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
@@ -35,14 +40,22 @@
    <dm:editurl>https://github.com/SUSE/doc-liberty/edit/main/xml/</dm:editurl>
    <dm:translation>no</dm:translation>
   </dm:docmanager>
-  <meta name="title" its:translate="yes">Registering &rhla; &productnumber; with RMT</meta>
-  <meta name="description" its:translate="yes">How to use SUSE Liberty Linux to update Red Hat Enterprise Linux 9.</meta>
-  <meta name="social-descr" its:translate="yes">How to use SUSE Liberty Linux to update RHEL 9.</meta>
+  <meta name="title" its:translate="yes">Registering &rhla; &productnumber; with &rmt;</meta>
+  <meta name="description" its:translate="yes">How to use SUSE Liberty Linux and RMT to update Red Hat Enterprise Linux 9.</meta>
+  <meta name="social-descr" its:translate="yes">How to use RMT to update RHEL 9.</meta>
   <meta name="task" its:translate="yes">
     <phrase>Upgrade &amp; Update</phrase>
     <phrase>Administration</phrase>
   </meta>
   <revhistory xml:id="rh-art-quickstart">
+    <revision>
+      <date>2024-10-31</date>
+      <revdescription>
+        <para>
+          Clarify the tools available with each subscription level.
+        </para>
+      </revdescription>
+    </revision>
     <revision>
       <date>2024-10-22</date>
       <revdescription>
@@ -82,23 +95,74 @@
   <title>Introduction</title>
    <para>
     &productname; is a technology and support solution for mixed Linux environments.
-    With a &productname; subscription, you can register and receive updates for
-    &rhel; and &sles;. An optional &ha; extension is also available.
+    With a &productname; subscription, you can register and update &rhel;.
+    An optional &ha; extension is also available.
+   </para>
+   <para>
+    The following table shows which Linux distributions are supported by each subscription. These
+    subscriptions also include an entitlement for a registration tool to manage package updates.
    </para>
+   <table xml:id="supported-distros-and-reg-tools">
+     <title>Supported distributions and registration options</title>
+     <tgroup cols="3">
+     <colspec colname="c1" colwidth="31%"/>
+     <colspec colname="c2" colwidth="38%"/>
+     <colspec colname="c3" colwidth="31%"/>
+       <thead>
+         <row>
+           <entry>Subscription<footnote><para>The <emphasis>Lite</emphasis> and
+           <emphasis>Basic</emphasis> subscriptions only support CentOS Linux,
+           so are not applicable to &productname;&nbsp;&productnumber;.</para></footnote></entry>
+           <entry>Supported distributions<footnote><para>There is no CentOS Linux &productnumber;, so
+           CentOS Linux support is not applicable to &productname;&nbsp;&productnumber;.</para></footnote></entry>
+           <entry>Registration options</entry>
+         </row>
+       </thead>
+       <tbody>
+         <row>
+           <entry><para><emphasis>&productname; Enterprise</emphasis></para></entry>
+           <entry>
+            <para>CentOS Linux</para>
+            <para>&rhel;</para>
+            <para>&sles;</para>
+           </entry>
+           <entry>
+            <para>&suma;</para>
+            <para>&rmtool;</para>
+           </entry>
+         </row>
+         <row>
+           <entry><para><emphasis>&productname; Professional</emphasis></para></entry>
+           <entry>
+            <para>CentOS Linux</para>
+            <para>&rhel;</para>
+           </entry>
+           <entry><para>&suma;</para></entry>
+         </row>
+       </tbody>
+     </tgroup>
+   </table>
    <important role="compact">
     <para>
      CentOS&nbsp;Stream is not supported.
     </para>
    </important>
+   <important role="compact">
+    <para>
+      Registering &rhla; directly with &scc; is not currently supported.
+    </para>
+   </important>
    <para>
-    You can register &rhla; &productnumber; with either &suma; or the &rmtool; (&rmt;).
-    Registering directly with the &scc; is not currently supported.
+    This guide describes how to register with &rmtool; (&rmt;). &rmt; is a proxy system for
+    &scc;. The &rmt; server is registered with &scc;, and other systems are registered with
+    the &rmt; server and receive packages from it directly.
    </para>
    <para>
-    This guide describes how to register with an &rmt; server. &rmt; is a proxy system for the
-    &scc;. The &rmt; server is registered with the &scc;, and other systems in the network are
-    registered with the &rmt; server and receive packages from it directly.
+    To register with &suma;, see
+    <link xlink:href="https://documentation.suse.com/liberty/9/html/suma-quickstart/art-suma-quickstart.html">
+    <citetitle>Registering &rhla; &productnumber; with &suma;</citetitle></link>.
    </para>
+
    <itemizedlist>
     <title>Procedure overview</title>
     <listitem>
@@ -132,22 +196,34 @@
     </listitem>
     <listitem>
      <para>
-      <link xlink:href="https://documentation.suse.com/liberty/7/html/quickstart/art-quickstart.html">
-      <citetitle>Registering &rhla; 7 or CentOS Linux 7 with RMT</citetitle></link>
+      <link xlink:href="https://documentation.suse.com/liberty/7/html/suma-quickstart/art-suma-quickstart.html">
+      <citetitle>Registering &rhla; 7 or CentOS Linux 7 with &suma;</citetitle></link>
      </para>
     </listitem>
     <listitem>
      <para>
-      <link xlink:href="https://documentation.suse.com/liberty/8/html/quickstart/art-quickstart.html">
-      <citetitle>Registering &rhla; 8 or CentOS Linux 8 with RMT</citetitle></link>
+      <link xlink:href="https://documentation.suse.com/liberty/7/html/quickstart/art-quickstart.html">
+      <citetitle>Registering &rhla; 7 or CentOS Linux 7 with &rmt;</citetitle></link>
      </para>
     </listitem>
     <listitem>
       <para>
-        <link xlink:href="https://documentation.suse.com/suma/4.3/en/suse-manager/client-configuration/clients-sleses.html">
-        <citetitle>&suma; Client Configuration Guide: Registering &sliberty; Clients</citetitle></link>
+        <link xlink:href="https://documentation.suse.com/liberty/8/html/suma-quickstart/art-suma-quickstart.html">
+        <citetitle>Registering &rhla; 8 or CentOS Linux 8 with &suma;</citetitle></link>
       </para>
     </listitem>
+    <listitem>
+     <para>
+      <link xlink:href="https://documentation.suse.com/liberty/8/html/quickstart/art-quickstart.html">
+      <citetitle>Registering &rhla; 8 or CentOS Linux 8 with &rmt;</citetitle></link>
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      <link xlink:href="https://documentation.suse.com/liberty/9/html/suma-quickstart/art-suma-quickstart.html">
+      <citetitle>Registering &rhla; 9 with &suma;</citetitle></link>
+     </para>
+    </listitem>
    </itemizedlist>
  </section>
 
@@ -175,7 +251,7 @@
     </listitem>
    </varlistentry>
    <varlistentry>
-    <term>&productname; doesn't appear in <command>rmt-cli products list</command>
+    <term>&productname; does not appear in <command>rmt-cli products list</command>
      after <command>rmt-cli sync</command></term>
     <listitem>
      <para>