Additional guidance for creating an abstract

Signed-off-by: Michal Maléř <mmaler@redhat.com>
quarkusio · Aug 16, 2022 · c7edb2d · c7edb2d
1 parent 03d1bc4
commit c7edb2d
Showing 1 changed file with 1 addition and 0 deletions.
diff --git a/docs/src/main/asciidoc/doc-reference.adoc b/docs/src/main/asciidoc/doc-reference.adoc
@@ -117,6 +117,7 @@ Start a new line at the end of each sentence, and split sentences themselves at
 === Abstracts (preamble)
 
 For optimum findability, add a short description using user-oriented keywords to summarize the document's purpose, task, and intent in no more than three sentences.
+Good abstracts also mention the benefits of following this content and avoid filler words, such as: "This document..", "This tutorial..", and "The following.."
 
 [IMPORTANT]
 ====