Improve layout and grouping for IndicativeSentences example

junit-team · Mar 2, 2025 · 29fdb58 · 29fdb58
1 parent 768ea90
commit 29fdb58
Showing 1 changed file with 6 additions and 3 deletions.
diff --git a/documentation/src/docs/asciidoc/user-guide/writing-tests.adoc b/documentation/src/docs/asciidoc/user-guide/writing-tests.adoc
@@ -227,15 +227,17 @@ ones available in Jupiter:
 | `IndicativeSentences`  | Generates complete sentences by concatenating the names of the test and the enclosing classes.
 |===
 
-Note that for `IndicativeSentences`, you can customize the separator and the
-underlying generator by using `@IndicativeSentencesGeneration` as shown in the
-following example.
+======
+Note that for `IndicativeSentences`, you can customize the separator and the underlying
+generator by using `@IndicativeSentencesGeneration` as shown in the following example.
 
 [source,java,indent=0]
 ----
 include::{testDir}/example/DisplayNameGeneratorDemo.java[tags=user_guide]
 ----
 
+Running the above `DisplayNameGeneratorDemo` test class results in the following display names.
+
 ```
 +-- DisplayNameGeneratorDemo [OK]
   +-- A year is not supported [OK]
@@ -250,6 +252,7 @@ include::{testDir}/example/DisplayNameGeneratorDemo.java[tags=user_guide]
       +-- Year 2020 is a leap year. [OK]
       '-- Year 2048 is a leap year. [OK]
 ```
+======
 
 
 [[writing-tests-display-name-generator-default]]