Rewording and adding paragraphs

Signed-off-by: Michal Maléř <[email protected]>

docs/src/main/asciidoc/logging.adoc

@@ -244,15 +244,30 @@ All potential properties are listed in the <<loggingConfigurationReference,loggi
 Logging is configured on a per-category basis, with each category being configured independently.
 Configuration for a category applies recursively to all subcategories unless there is a more specific subcategory configuration.
 
-The parent of all logging categories is called the "root" category.
+The parent of all logging categories is called the "root category."
 As the ultimate parent, this category might contain a configuration that applies globally to all other categories.
 This includes the globally configured handlers and formatters.
 
-An example of a global configuration that applies for all categories:
+.An example of a global configuration that applies for all categories:
+====
+[source, properties]
+----
+quarkus.log.handlers=console,mylog
+----
+
+In this example, the root category is configured to use two handlers: `console` and `mylog`.
+====
 
-* `quarkus.log.console.pass:c,a[*]`
-* `quarkus.log.file.pass:c,a[*]`
-* `quarkus.log.syslog.pass:c,a[*]`
+.An example of a per-category configuration:
+====
+[source, properties]
+----
+quarkus.log.category."org.apache.kafka.clients".level=INFO
+quarkus.log.category."org.apache.kafka.common.utils".level=INFO
+----
+
+In this example, we configure the minimal log level of the “org.apache.kafka.clients” and “org.apache.kafka.common.utils” categories.
+====
 
 For more information, see <<loggingConfigurationReference>>.