concept template: rephrase section titles

SUSE · Aug 16, 2021 · 5d895b9 · 5d895b9
1 parent 2dbd1fb
commit 5d895b9
Showing 1 changed file with 9 additions and 6 deletions.
diff --git a/templates/xml/concept.xml b/templates/xml/concept.xml
@@ -59,16 +59,18 @@
  </section>
 
  <section>
-  <title>Function (what is the aim?)</title>
+  <title>What is foo bar?</title>
   <para>
-   A paragraph of text.
+   A paragraph of text, answering the question above and
+   explaining the aim/function of foo bar.
   </para>
  </section>
 
  <section>
-  <title>Mechanism (how does it work?)</title>
+  <title>How does foo bar work?</title>
   <para>
-   A paragraph of text.
+   A paragraph of text, answering the question above and
+   explaining the mechanism behind foo bar.
   </para>
   <figure xml:id="fig-one">
    <title>A figure</title>
@@ -84,9 +86,10 @@
  </section>
 
  <section>
-  <title>Benefits</title>
+  <title>Benefits of foo bar</title>
   <para>
-   A paragraph of text.
+   A paragraph of text, pointing out the benefits
+   of foo bar.
   </para>
  </section>