Changes in SUMA integration

trento/xml/article_sap_trento.xml

@@ -1757,13 +1757,12 @@ In the Trento dashboard, go to the overview corresponding to the object for whic
       </section>
     </section>
 
-
   <section xml:id="sec-integration-with-SUSE-Manager">
       <title>Integration with &suma;</title>
-      <para>Trento integrates with &suma; to provide the &sap; admin with
-      a summary of available patches and upgradable packages for any registered host
-      that is also managed by given instance of &suma;.</para>
-      <para>The user must enter the connection settings for the &suma; instance
+      <para>Trento integrates with &suma; to provide the &sap; administrator with
+      information about available patches and upgradable packages for any host
+       that is registered with both applications.</para>
+      <para>The user must enter the connection settings for &suma;
        in the <guimenu>Settings</guimenu> view:</para>
      <figure>
          <title>&suma; settings</title>
@@ -1775,11 +1774,11 @@ In the Trento dashboard, go to the overview corresponding to the object for whic
         </mediaobject>
       </figure>  
    <para>
-   With the &suma; settings configured, the &sap; admin can test the connection
-   by clicking <guimenu>Test Connection</guimenu>.
-   If the connection is successful, the Host Details view displays a summary
-   of the available patches and the upgradable packages for each host
-   managed by &suma;:</para>
+   Once the &suma; settings are configured, the &sap; administrator can test the connection
+   by clicking the <guimenu>Test</guimenu> button.
+   If the connection is successful, the <guimenu>Host Details</guimenu> view of each host
+   managed by &suma; displays a summary
+   of available patches and upgradable packages:</para>
         <figure>
          <title><guimenu>Availale software updates in the Host Details view</guimenu></title>
         <mediaobject>
@@ -1789,9 +1788,43 @@ In the Trento dashboard, go to the overview corresponding to the object for whic
           </imageobject>
         </mediaobject>
       </figure>
-   <para>There are three types of available patches: security advisories, bug fixes and feature
-   enhancement. Security advisories are regarded as critical. If one is found,
-   the health of the host will be set to critical too. The others are to be seen as warnings.</para>
+   <para>Click on <guimenu>Relevant Patches</guimenu> to open the <guimenu>Relevant Patches</guimenu> overview containing a list of patches available for that particular host:</para>
+           <figure>
+         <title><guimenu>Available Patches overview</guimenu></title>
+        <mediaobject>
+          <imageobject>
+            <imagedata
+              fileref="trento-available-patches-overview.png" />
+          </imageobject>
+        </mediaobject>
+      </figure>
+      <para>Click <guimenu>Upgradable Packages</guimenu> to open the <guimenu>Upgradable Packages</guimenu> overview containing a list of packages that can be upgraded on that particular host:</para>
+           <figure>
+         <title><guimenu>Upgradable Packages overview</guimenu></title>
+        <mediaobject>
+          <imageobject>
+            <imagedata
+              fileref="trento-upgradable-packages-overview.png" />
+          </imageobject>
+        </mediaobject>
+      </figure>
+   <para> Click  on an advisory or patch link to access the corresponding details view. This view shows
+   relevant information, such as whether it requires a reboot, associated 
+    vulnerabilities, or a list of affected hosts:</para>
+            <figure>
+         <title><guimenu>Advisory Details view</guimenu></title>
+        <mediaobject>
+          <imageobject>
+            <imagedata
+              fileref="trento-advisory-details-view.png" />
+          </imageobject>
+        </mediaobject>
+      </figure>  
+   <para>There are three types of patches or advisories: security advisories, bug fixes, and feature
+   enhancements. Security advisories are considered as critical. The health status of the host is set to critical if there is a security advisory. If there are patches available, but none of them
+    is a security-related, the health status of the host switches to warning. When a host cannot be found in
+    &suma;, or there is a problem retrieving the data for it, its health status is set as unknnown. 
+   </para>
     <para>
     At any time, the user can clear the &suma; settings from the Settings view. 
     As a result, all information about available software updates disappears from the console and the status of the hosts is adjusted accordingly.</para>