From ada076a5dea318d10d5b4d7d7febd487c6a44d03 Mon Sep 17 00:00:00 2001
From: Daria Vladykina <daria.vladykina@suse.com>
Date: Tue, 13 Jan 2026 10:38:08 +0100
Subject: [PATCH] Update assembly.asm.xml

Updated descriptions in the Abstract block.
---
 smart-doc/articles/assembly.asm.xml | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/smart-doc/articles/assembly.asm.xml b/smart-doc/articles/assembly.asm.xml
index fa77313..dc936ee 100644
--- a/smart-doc/articles/assembly.asm.xml
+++ b/smart-doc/articles/assembly.asm.xml
@@ -129,12 +129,13 @@ The newest revision history comes first in the list -->
         <dm:translation>yes</dm:translation>
       </dm:docmanager>
       <abstract>
+       <!-- Use the fixed abstract structure defined in the style guide to keep abstracts consistent across all articles-->
       <variablelist>
         <varlistentry>
           <term>WHAT?</term>
           <listitem>
             <para>
-              Describe your topic in one sentence.
+              Provide an objective, one-sentence definition of the product, feature or solution.
             </para>
           </listitem>
         </varlistentry>
@@ -142,7 +143,7 @@ The newest revision history comes first in the list -->
           <term>WHY?</term>
           <listitem>
             <para>
-              State the reason why one should read this.
+              Explain why the reader should care and what problem or benefit this content addresses.
             </para>
           </listitem>
         </varlistentry>
@@ -150,7 +151,7 @@ The newest revision history comes first in the list -->
           <term>EFFORT</term>
             <listitem>
               <para>
-                What's the effort one has to put in?
+                 State the expected time investment and any required background knowledge.
               </para>
             </listitem>
         </varlistentry>
@@ -158,7 +159,7 @@ The newest revision history comes first in the list -->
           <term>GOAL</term>
             <listitem>
               <para>
-                What's the reader's take-away from this article?
+                Describe the concrete outcome after the reader finishes this article.
               </para>
             </listitem>
         </varlistentry>
@@ -168,7 +169,7 @@ The newest revision history comes first in the list -->
               <itemizedlist>
                 <listitem>
                   <para>
-                    List the requirements to accomplish the task(s) described below.
+                    List prerequisites needed to complete the tasks described in this article.
                   </para>
                 </listitem>
               </itemizedlist>