Use admonitions as titles for sections

Author: jaapio

docs/reference/restructuredtext/admonitions.rst

@@ -5,15 +5,15 @@ Admonitions
 ===========
 
 Admonitions are blocks of text that are rendered in a special way to draw attention to them. They are often used to
-provide additional information to the reader about the content that is being discussed.
-
-Examples
-========
+provide additional information to the reader about the content that is being discussed. t6est
 
 .. index:: reST directives; seealso
 
 .. phpdoc:class-list:: [?(@.inheritedElement == "\phpDocumentor\Guides\RestructuredText\Directives\AbstractAdmonitionDirective")]
 
    .. phpdoc:name::
+      :title: true
+      :level: 2
+
    .. phpdoc:summary::
    .. phpdoc:description::