X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;ds=sidebyside;f=README.adoc;h=e00504437f96e31846c23024414b4825a038fb65;hb=a94a57d7b369c3fe0d20905020f7b7d8168b617e;hp=e95a116cafd769fccdc447786376dbc31ae58b71;hpb=1ff5e4e80ebfdab700d14abbe18da65cbdbb147a;p=pve-docs.git

diff --git a/README.adoc b/README.adoc
index e95a116..e005044 100644
--- a/README.adoc
+++ b/README.adoc
@@ -96,6 +96,10 @@ below the title text:
  Level 3:                 ^^^^^^^^^^^^^^^^^^^^^^
  Level 4 (bottom level):  ++++++++++++++++++++++
 
+NOTE: Level 4 headings are currently not working for `manpage` outputs, you may
+want to use `.SECTION' instead, which results in the same rendering, and this
+level of Heading isn't displayed in any Index/TOC anyway.
+
 Section titles should always be preceded by two empty lines. Each word
 in a title should be capitalized except for ``articles, coordinating
 conjunctions, prepositions, and the word to in infinitives unless they
@@ -138,6 +142,24 @@ Bulleted lists should be created using the '*' symbol:
 * First level again
 
 
+If you need to have other elements on the same level than a list element you
+can do this with the '+' symbol:
+
+----
+. First level
+.. Second level
++
+Anothe Sentence (or Block) on the continued second level.
+. First level again
+----
+
+. First level
+.. Second level
++
+Anothe Sentence (or Block) on the continued second level.
+
+. First level again
+
 Labeled Lists
 ^^^^^^^^^^^^^