General improvements to mirroring and registration procedures

Author: tahliar

xml/app-access-src-debug.xml

@@ -51,7 +51,7 @@
     </listitem>
     <listitem>
       <para>
-        Your &rhla; system is registered with the &rmt; server.
+        Your &rhla; system is registered to the &rmt; server.
       </para>
     </listitem>
   </itemizedlist>

xml/art-quickstart-rmt.xml

@@ -120,7 +120,7 @@
     package dependencies</term>
     <listitem>
      <para>
-      &productname; only supports the latest minor release of &rhla;.
+      &productname; only supports the latest minor version of each &rhla; release.
       If your system is running the latest version and <package>SUSEConnect</package>
       still has package dependency issues, try the following workaround:
      </para>

xml/mirror-repositories-with-rmt.xml

@@ -72,14 +72,14 @@
   </step>
   <step>
    <para>
-    If your subscription includes the &ha; extension, enable the extension using
+    If your subscription includes the &ha; extension, enable it using
     the product ID <literal>3142</literal>:
    </para>
 <screen>&prompt.root;<command>rmt-cli products enable 3142</command></screen>
    <tip role="compact">
     <para>
-     To check whether the &ha; extension is available, run this
-     command: <command>rmt-cli products list --all --name=&reponameshort;-HA</command>
+     To check whether the extension is available, run
+     <command>rmt-cli products list --all --name=&reponameshort;-HA</command>.
     </para>
    </tip>
   </step>

xml/register-with-rmt.xml

@@ -21,6 +21,11 @@
  <para>
   Use this procedure to register &rhel; &productnumber; as a client of &rmt;.
  </para>
+ <important role="compact">
+  <para>
+   &productname; only supports the latest minor version of &rhla; &productnumber;.
+  </para>
+ </important>
  <important role="compact">
   <para>
    &centos; Stream is not supported.
@@ -43,12 +48,6 @@
     The system you want to register can access the &rmt; server.
    </para>
   </listitem>
-  <listitem>
-   <para>
-    The system you want to register is up to date. &productname; only supports the latest
-    minor release of &rhla; &productnumber;.
-   </para>
-  </listitem>
   <listitem>
    <para>
     You have a &productname; subscription activated in the <link xlink:href="&sccurl;">&scc;</link>.
@@ -66,7 +65,11 @@
    <para>
     On the &rhla; system, download the <filename>rmt-client-setup-res</filename> script:
    </para>
-<screen>&prompt.root;<command>curl -O http://<replaceable>&rmt;_SERVER</replaceable>/tools/rmt-client-setup-res</command></screen>
+<screen>&prompt.root;<command>curl --remote-name http://<replaceable>&rmt;_SERVER</replaceable>/tools/rmt-client-setup-res</command></screen>
+   <para>
+    The option <option>--remote-name</option> (or <option>-O</option>) writes the output to a local
+    file with the same name as the remote file.
+   </para>
   </step>
   <step>
    <para>
@@ -138,14 +141,12 @@ Installed Products:
   </step>
   <step>
    <para>
-    If your subscription includes the &ha; extension, activate it with the
-    following command:
+    If your subscription includes the &ha; extension, activate it with this command:
    </para>
 <screen>&prompt.root;<command>&suseconnect; -p &reponameshort;-HA/&productnumber;/x86_64</command></screen>
    <tip role="compact">
     <para>
-     To check whether the extension is available, run the
-     <command>&suseconnect; --list-extensions</command> command.
+     To check whether the extension is available, run <command>&suseconnect; --list-extensions</command>.
     </para>
    </tip>
   </step>
@@ -162,7 +163,7 @@ Installed Products:
     should also be <literal>enabled</literal>.
    </para>
    <para>
-     You will also see optional <literal>Source</literal> and <literal>Debug</literal>
+    You will also see optional <literal>Source</literal> and <literal>Debug</literal>
      repositories with the status <literal>disabled</literal>. Be aware that these
      repositories are listed even if they are not mirrored on the &rmt; server.
      You can check the mirrored repositories by browsing the directory listing at
@@ -173,9 +174,9 @@ Installed Products:
   <step>
     <para>
       If you need the <literal>Source</literal> or <literal>Debug</literal> repositories,
-      enable them with the following command:
+      enable them with the following command. You can enable multiple repositories at once:
     </para>
-<screen>&prompt.root;<command>dnf config-manager --enable <replaceable>REPO_ID</replaceable></command></screen>
+<screen>&prompt.root;<command>dnf config-manager --enable <replaceable>REPO_ID1</replaceable> <replaceable>REPO_ID2</replaceable> <replaceable>REPO_ID3</replaceable></command></screen>
   </step>
   <step>
    <para>