diff --git a/.doctrees/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.doctree b/.doctrees/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.doctree
index 8d5deea..9e1f38e 100644
Binary files a/.doctrees/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.doctree and b/.doctrees/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.doctree differ
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
index f71a320..ed6fb98 100644
Binary files a/.doctrees/environment.pickle and b/.doctrees/environment.pickle differ
diff --git a/_sources/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.rst.txt b/_sources/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.rst.txt
index e51f460..9b9cad8 100644
--- a/_sources/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.rst.txt
+++ b/_sources/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.rst.txt
@@ -71,7 +71,7 @@ Output
    </strong>
 
 Lists
-~~~~~
+-----
 
 Two spaces are required after new lines
 
diff --git a/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.html b/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.html
index d625346..f06cdf3 100644
--- a/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.html
+++ b/developer-guides/documentation/valadoc-guide/03-00-documentation-comment-markup/03-02-formatting.html
@@ -525,12 +525,12 @@ <h3><span class="section-number">3.1.2.2.2. </span>Output<a class="headerlink" h
     <span class="underline">bold italic underlined</span>
   </em>
 </strong></section>
+</section>
 <section id="lists">
-<h3><span class="section-number">3.1.2.2.3. </span>Lists<a class="headerlink" href="#lists" title="Permalink to this heading">¶</a></h3>
+<h2><span class="section-number">3.1.2.3. </span>Lists<a class="headerlink" href="#lists" title="Permalink to this heading">¶</a></h2>
 <p>Two spaces are required after new lines</p>
-</section>
 <section id="id3">
-<h3><span class="section-number">3.1.2.2.4. </span>Comment<a class="headerlink" href="#id3" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.3.1. </span>Comment<a class="headerlink" href="#id3" title="Permalink to this heading">¶</a></h3>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="cm">/**</span>
 <span class="cm"> * Short description</span>
 <span class="cm"> *</span>
@@ -574,7 +574,7 @@ <h3><span class="section-number">3.1.2.2.4. </span>Comment<a class="headerlink"
 </div>
 </section>
 <section id="id4">
-<h3><span class="section-number">3.1.2.2.5. </span>Output<a class="headerlink" href="#id4" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.3.2. </span>Output<a class="headerlink" href="#id4" title="Permalink to this heading">¶</a></h3>
 <p>Short description</p>
 <ol class="arabic simple">
 <li><p>numbered list</p></li>
@@ -629,9 +629,9 @@ <h3><span class="section-number">3.1.2.2.5. </span>Output<a class="headerlink" h
 </section>
 </section>
 <section id="code-blocks">
-<h2><span class="section-number">3.1.2.3. </span>Code Blocks<a class="headerlink" href="#code-blocks" title="Permalink to this heading">¶</a></h2>
+<h2><span class="section-number">3.1.2.4. </span>Code Blocks<a class="headerlink" href="#code-blocks" title="Permalink to this heading">¶</a></h2>
 <section id="id5">
-<h3><span class="section-number">3.1.2.3.1. </span>Comment<a class="headerlink" href="#id5" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.4.1. </span>Comment<a class="headerlink" href="#id5" title="Permalink to this heading">¶</a></h3>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="cm">/**</span>
 <span class="cm">* Short description</span>
 <span class="cm">*</span>
@@ -646,7 +646,7 @@ <h3><span class="section-number">3.1.2.3.1. </span>Comment<a class="headerlink"
 </div>
 </section>
 <section id="id6">
-<h3><span class="section-number">3.1.2.3.2. </span>Output<a class="headerlink" href="#id6" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.4.2. </span>Output<a class="headerlink" href="#id6" title="Permalink to this heading">¶</a></h3>
 <p>Short description</p>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="kd">static</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="w"> </span><span class="p">(</span><span class="kt">string</span><span class="p">[]</span><span class="w"> </span><span class="n">arg</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
 <span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
@@ -656,9 +656,9 @@ <h3><span class="section-number">3.1.2.3.2. </span>Output<a class="headerlink" h
 </section>
 </section>
 <section id="images-and-links">
-<h2><span class="section-number">3.1.2.4. </span>Images and Links<a class="headerlink" href="#images-and-links" title="Permalink to this heading">¶</a></h2>
+<h2><span class="section-number">3.1.2.5. </span>Images and Links<a class="headerlink" href="#images-and-links" title="Permalink to this heading">¶</a></h2>
 <section id="id7">
-<h3><span class="section-number">3.1.2.4.1. </span>Comment<a class="headerlink" href="#id7" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.5.1. </span>Comment<a class="headerlink" href="#id7" title="Permalink to this heading">¶</a></h3>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
 <p>Only local images can be used</p>
@@ -672,16 +672,16 @@ <h3><span class="section-number">3.1.2.4.1. </span>Comment<a class="headerlink"
 </div>
 </section>
 <section id="id8">
-<h3><span class="section-number">3.1.2.4.2. </span>Output<a class="headerlink" href="#id8" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.5.2. </span>Output<a class="headerlink" href="#id8" title="Permalink to this heading">¶</a></h3>
 <p><a class="reference external" href="https://vala.dev">Vala</a> <a class="reference external" href="https://vala.dev">https://vala.dev</a></p>
 <img alt="../../../../_images/logo.png" src="../../../../_images/logo.png" />
 <img alt="alt-message" src="../../../../_images/logo.png" />
 </section>
 </section>
 <section id="tables">
-<h2><span class="section-number">3.1.2.5. </span>Tables<a class="headerlink" href="#tables" title="Permalink to this heading">¶</a></h2>
+<h2><span class="section-number">3.1.2.6. </span>Tables<a class="headerlink" href="#tables" title="Permalink to this heading">¶</a></h2>
 <section id="id9">
-<h3><span class="section-number">3.1.2.5.1. </span>Comment<a class="headerlink" href="#id9" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.6.1. </span>Comment<a class="headerlink" href="#id9" title="Permalink to this heading">¶</a></h3>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="cm">/**</span>
 <span class="cm"> * Short description</span>
 <span class="cm"> *</span>
@@ -694,7 +694,7 @@ <h3><span class="section-number">3.1.2.5.1. </span>Comment<a class="headerlink"
 </div>
 </section>
 <section id="id10">
-<h3><span class="section-number">3.1.2.5.2. </span>Output<a class="headerlink" href="#id10" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.6.2. </span>Output<a class="headerlink" href="#id10" title="Permalink to this heading">¶</a></h3>
 <p>Short description</p>
 <div class="table-wrapper docutils container">
 <table class="docutils align-default">
@@ -716,9 +716,9 @@ <h3><span class="section-number">3.1.2.5.2. </span>Output<a class="headerlink" h
 </section>
 </section>
 <section id="headers">
-<h2><span class="section-number">3.1.2.6. </span>Headers<a class="headerlink" href="#headers" title="Permalink to this heading">¶</a></h2>
+<h2><span class="section-number">3.1.2.7. </span>Headers<a class="headerlink" href="#headers" title="Permalink to this heading">¶</a></h2>
 <section id="id11">
-<h3><span class="section-number">3.1.2.6.1. </span>Comment<a class="headerlink" href="#id11" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.7.1. </span>Comment<a class="headerlink" href="#id11" title="Permalink to this heading">¶</a></h3>
 <div class="highlight-vala notranslate"><div class="highlight"><pre><span></span><span class="cm">/**</span>
 <span class="cm"> * Short description</span>
 <span class="cm"> *</span>
@@ -731,7 +731,7 @@ <h3><span class="section-number">3.1.2.6.1. </span>Comment<a class="headerlink"
 </div>
 </section>
 <section id="id12">
-<h3><span class="section-number">3.1.2.6.2. </span>Output<a class="headerlink" href="#id12" title="Permalink to this heading">¶</a></h3>
+<h3><span class="section-number">3.1.2.7.2. </span>Output<a class="headerlink" href="#id12" title="Permalink to this heading">¶</a></h3>
 <h1>header 1</h1>
 <h2>header 2</h2>
 <h3>header 3</h3>
@@ -790,29 +790,31 @@ <h4>header 4</h4></section>
 <li><a class="reference internal" href="#text-highlighting">3.1.2.2. Text Highlighting</a><ul>
 <li><a class="reference internal" href="#id1">3.1.2.2.1. Comment</a></li>
 <li><a class="reference internal" href="#id2">3.1.2.2.2. Output</a></li>
-<li><a class="reference internal" href="#lists">3.1.2.2.3. Lists</a></li>
-<li><a class="reference internal" href="#id3">3.1.2.2.4. Comment</a></li>
-<li><a class="reference internal" href="#id4">3.1.2.2.5. Output</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#code-blocks">3.1.2.3. Code Blocks</a><ul>
-<li><a class="reference internal" href="#id5">3.1.2.3.1. Comment</a></li>
-<li><a class="reference internal" href="#id6">3.1.2.3.2. Output</a></li>
+<li><a class="reference internal" href="#lists">3.1.2.3. Lists</a><ul>
+<li><a class="reference internal" href="#id3">3.1.2.3.1. Comment</a></li>
+<li><a class="reference internal" href="#id4">3.1.2.3.2. Output</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#code-blocks">3.1.2.4. Code Blocks</a><ul>
+<li><a class="reference internal" href="#id5">3.1.2.4.1. Comment</a></li>
+<li><a class="reference internal" href="#id6">3.1.2.4.2. Output</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#images-and-links">3.1.2.4. Images and Links</a><ul>
-<li><a class="reference internal" href="#id7">3.1.2.4.1. Comment</a></li>
-<li><a class="reference internal" href="#id8">3.1.2.4.2. Output</a></li>
+<li><a class="reference internal" href="#images-and-links">3.1.2.5. Images and Links</a><ul>
+<li><a class="reference internal" href="#id7">3.1.2.5.1. Comment</a></li>
+<li><a class="reference internal" href="#id8">3.1.2.5.2. Output</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#tables">3.1.2.5. Tables</a><ul>
-<li><a class="reference internal" href="#id9">3.1.2.5.1. Comment</a></li>
-<li><a class="reference internal" href="#id10">3.1.2.5.2. Output</a></li>
+<li><a class="reference internal" href="#tables">3.1.2.6. Tables</a><ul>
+<li><a class="reference internal" href="#id9">3.1.2.6.1. Comment</a></li>
+<li><a class="reference internal" href="#id10">3.1.2.6.2. Output</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#headers">3.1.2.6. Headers</a><ul>
-<li><a class="reference internal" href="#id11">3.1.2.6.1. Comment</a></li>
-<li><a class="reference internal" href="#id12">3.1.2.6.2. Output</a></li>
+<li><a class="reference internal" href="#headers">3.1.2.7. Headers</a><ul>
+<li><a class="reference internal" href="#id11">3.1.2.7.1. Comment</a></li>
+<li><a class="reference internal" href="#id12">3.1.2.7.2. Output</a></li>
 </ul>
 </li>
 </ul>