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 -->
yes
+
WHAT?
- Describe your topic in one sentence.
+ Provide an objective, one-sentence definition of the product, feature or solution.
@@ -142,7 +143,7 @@ The newest revision history comes first in the list -->
WHY?
- State the reason why one should read this.
+ Explain why the reader should care and what problem or benefit this content addresses.
@@ -150,7 +151,7 @@ The newest revision history comes first in the list -->
EFFORT
- What's the effort one has to put in?
+ State the expected time investment and any required background knowledge.
@@ -158,7 +159,7 @@ The newest revision history comes first in the list -->
GOAL
- What's the reader's take-away from this article?
+ Describe the concrete outcome after the reader finishes this article.
@@ -168,7 +169,7 @@ The newest revision history comes first in the list -->
- List the requirements to accomplish the task(s) described below.
+ List prerequisites needed to complete the tasks described in this article.