From 18f130dc7a6d77fb6382b38d7fa50610ac67d525 Mon Sep 17 00:00:00 2001
From: Tahlia Richardson <3069029+tahliar@users.noreply.github.com>
Date: Fri, 25 Oct 2024 17:52:21 +1000
Subject: [PATCH] Initial guide stub

---
 DC-quickstart               |   2 +-
 DC-suma-quickstart          |  12 +++
 xml/art-quickstart.xml      |   2 +-
 xml/art-suma-quickstart.xml | 141 ++++++++++++++++++++++++++++++++++++
 4 files changed, 155 insertions(+), 2 deletions(-)
 create mode 100644 DC-suma-quickstart
 create mode 100644 xml/art-suma-quickstart.xml

diff --git a/DC-quickstart b/DC-quickstart
index 9097858..67f54f0 100644
--- a/DC-quickstart
+++ b/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"
diff --git a/DC-suma-quickstart b/DC-suma-quickstart
new file mode 100644
index 0000000..0c8b141
--- /dev/null
+++ b/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"
diff --git a/xml/art-quickstart.xml b/xml/art-quickstart.xml
index 1e16f11..848a5bb 100644
--- a/xml/art-quickstart.xml
+++ b/xml/art-quickstart.xml
@@ -15,7 +15,7 @@
  xmlns:xlink="http://www.w3.org/1999/xlink">
 
  <info>
-  <title>Registering &rhla; &productnumber; or CentOS Linux &productnumber; with RMT</title>
+  <title>Registering &rhla; &productnumber; or CentOS Linux &productnumber; with &rmt;</title>
   <productname>&productname;</productname>
   <productname role="abbrev">&productnameshort;</productname>
   <date><?dbtimestamp format="B d, Y"?></date>
diff --git a/xml/art-suma-quickstart.xml b/xml/art-suma-quickstart.xml
new file mode 100644
index 0000000..1d549c3
--- /dev/null
+++ b/xml/art-suma-quickstart.xml
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook51-profile.xsl"
+ type="text/xml"
+ title="Profiling step"?>
+<!DOCTYPE article
+[
+  <!ENTITY % entities SYSTEM "generic-entities.ent">
+    %entities;
+]>
+
+<article xml:id="art-suma-quickstart" xml:lang="en"
+ xmlns="http://docbook.org/ns/docbook" version="5.1"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns:xlink="http://www.w3.org/1999/xlink">
+
+ <info>
+  <title>Registering &rhla; &productnumber; or CentOS Linux &productnumber; with &suma;</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;
+    or CentOS&nbsp;Linux&nbsp;&productnumber;.
+   </para>
+  </abstract>
+  <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
+   <dm:bugtracker>
+    <dm:url>https://github.com/SUSE/doc-liberty/issues/new</dm:url>
+    <dm:labels>documentation,issue</dm:labels>
+    <dm:version>8</dm:version>
+    <dm:assignee>tahliar</dm:assignee>
+   </dm:bugtracker>
+   <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; or CentOS Linux 8 with &suma;</meta>
+  <meta name="description" its:translate="yes">How to use SUSE Liberty Linux to update Red Hat Enterprise Linux 8 or CentOS Linux 8.</meta>
+  <meta name="social-descr" its:translate="yes">Use SUSE Liberty Linux to update RHEL 8 or CentOS 8.</meta>
+  <meta name="task" its:translate="yes">
+    <phrase>Upgrade &amp; Update</phrase>
+    <phrase>Administration</phrase>
+  </meta>
+  <revhistory xml:id="rh-art-suma-quickstart">
+    <revision>
+      <date>2024-10-25</date>
+      <revdescription>
+        <para>
+          Initial guide creation.
+        </para>
+      </revdescription>
+    </revision>
+  </revhistory>
+ </info>
+
+  <section xml:id="introduction-suma-quickstart">
+    <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;, CentOS Linux, and &sles;. An optional &ha; extension is also available.
+   </para>
+   <important role="compact">
+    <para>
+     CentOS&nbsp;Stream is not supported.
+    </para>
+   </important>
+   <para>
+    You can register &rhla; &productnumber; or CentOS Linux &productnumber; with either &suma;
+    or the &rmtool; (&rmt;). Registering directly with the &scc; is not currently supported.
+   </para>
+   <para>
+    This guide describes how to register with &suma;.
+   </para>
+   <itemizedlist>
+    <title>Procedure overview</title>
+    <listitem>
+     <para>
+      If &suma; is already set up and you only need to <emphasis role="bold">register your
+      &rhla;&nbsp;&productnumber; or CentOS&nbsp;Linux&nbsp;&productnumber; system</emphasis>,
+      skip straight to <xref linkend="register-8-with-suma"/>.
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      If you still need to <emphasis role="bold">set up &suma;</emphasis>, start with
+      <xref linkend="deploy-suma"/>.
+     </para>
+    </listitem>
+   </itemizedlist>
+   <note><!-- Can delete this if/when all names have been changed
+              trichardson 2024-06-26: Repo names have changed but repo labels still include RES -->
+    <title><emphasis>&productname;</emphasis> and <emphasis>&sles; with Expanded Support</emphasis></title>
+    <para>
+     <emphasis>&productname;</emphasis> now provides what used to be covered by
+     the <emphasis>&sles; with Expanded Support</emphasis> subscription. Some
+     components might still use the <emphasis>Expanded Support</emphasis> name
+     during the transition period.
+    </para>
+   </note>
+   <itemizedlist>
+    <title>Related information</title>
+    <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>
+     </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/quickstart/art-quickstart.html">
+      <citetitle>Registering &rhla; 9 with &rmt;</citetitle></link>
+     </para>
+    </listitem>
+   </itemizedlist>
+  </section>
+
+  <section xml:id="deploy-suma">
+    <title>Deploying &suma;</title>
+    <para>
+      <link xlink:href="https://documentation.suse.com/suma/5.0/en/suse-manager/installation-and-upgrade/installation-and-upgrade-overview.html">Installation and Upgrade Guide</link> or
+      <link xlink:href="https://documentation.suse.com/suma/5.0/en/suse-manager/quickstart/quickstart-overview.html">Quick Start</link>.
+    </para>
+  </section>
+
+  <section xml:id="register-8-with-suma">
+    <title>Registering &rhla; or CentOS Linux with &suma;</title>
+    <para>
+      <link xlink:href="https://documentation.suse.com/suma/5.0/en/suse-manager/client-configuration/clients-sleses.html">Registering SUSE Liberty Linux Clients</link>.
+    </para>
+  </section>
+
+ <xi:include href="common_legal.xml"/>
+</article>