diff --git a/CHANGELOG.md b/CHANGELOG.md
index 81bc2c17..f661e0f5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,166 +2,169 @@
 
 **Topics**
 
-- <a href="#v2-16-1">v2\.16\.1</a>
+- <a href="#v2-16-2">v2\.16\.2</a>
     - <a href="#release-summary">Release Summary</a>
     - <a href="#bugfixes">Bugfixes</a>
-- <a href="#v2-16-0">v2\.16\.0</a>
+- <a href="#v2-16-1">v2\.16\.1</a>
     - <a href="#release-summary-1">Release Summary</a>
+    - <a href="#bugfixes-1">Bugfixes</a>
+- <a href="#v2-16-0">v2\.16\.0</a>
+    - <a href="#release-summary-2">Release Summary</a>
     - <a href="#minor-changes">Minor Changes</a>
 - <a href="#v2-15-0">v2\.15\.0</a>
-    - <a href="#release-summary-2">Release Summary</a>
+    - <a href="#release-summary-3">Release Summary</a>
     - <a href="#minor-changes-1">Minor Changes</a>
 - <a href="#v2-14-0">v2\.14\.0</a>
-    - <a href="#release-summary-3">Release Summary</a>
+    - <a href="#release-summary-4">Release Summary</a>
     - <a href="#minor-changes-2">Minor Changes</a>
 - <a href="#v2-13-1">v2\.13\.1</a>
-    - <a href="#release-summary-4">Release Summary</a>
-    - <a href="#bugfixes-1">Bugfixes</a>
-- <a href="#v2-13-0">v2\.13\.0</a>
     - <a href="#release-summary-5">Release Summary</a>
-    - <a href="#minor-changes-3">Minor Changes</a>
     - <a href="#bugfixes-2">Bugfixes</a>
-- <a href="#v2-12-0">v2\.12\.0</a>
+- <a href="#v2-13-0">v2\.13\.0</a>
     - <a href="#release-summary-6">Release Summary</a>
-    - <a href="#minor-changes-4">Minor Changes</a>
+    - <a href="#minor-changes-3">Minor Changes</a>
     - <a href="#bugfixes-3">Bugfixes</a>
-- <a href="#v2-11-0">v2\.11\.0</a>
+- <a href="#v2-12-0">v2\.12\.0</a>
     - <a href="#release-summary-7">Release Summary</a>
-    - <a href="#minor-changes-5">Minor Changes</a>
+    - <a href="#minor-changes-4">Minor Changes</a>
     - <a href="#bugfixes-4">Bugfixes</a>
-- <a href="#v2-10-0">v2\.10\.0</a>
+- <a href="#v2-11-0">v2\.11\.0</a>
     - <a href="#release-summary-8">Release Summary</a>
-    - <a href="#minor-changes-6">Minor Changes</a>
+    - <a href="#minor-changes-5">Minor Changes</a>
     - <a href="#bugfixes-5">Bugfixes</a>
-- <a href="#v2-9-0">v2\.9\.0</a>
+- <a href="#v2-10-0">v2\.10\.0</a>
     - <a href="#release-summary-9">Release Summary</a>
+    - <a href="#minor-changes-6">Minor Changes</a>
+    - <a href="#bugfixes-6">Bugfixes</a>
+- <a href="#v2-9-0">v2\.9\.0</a>
+    - <a href="#release-summary-10">Release Summary</a>
     - <a href="#minor-changes-7">Minor Changes</a>
 - <a href="#v2-8-0">v2\.8\.0</a>
-    - <a href="#release-summary-10">Release Summary</a>
-    - <a href="#minor-changes-8">Minor Changes</a>
-    - <a href="#bugfixes-6">Bugfixes</a>
-- <a href="#v2-7-0">v2\.7\.0</a>
     - <a href="#release-summary-11">Release Summary</a>
-    - <a href="#minor-changes-9">Minor Changes</a>
+    - <a href="#minor-changes-8">Minor Changes</a>
     - <a href="#bugfixes-7">Bugfixes</a>
-- <a href="#v2-6-1">v2\.6\.1</a>
+- <a href="#v2-7-0">v2\.7\.0</a>
     - <a href="#release-summary-12">Release Summary</a>
+    - <a href="#minor-changes-9">Minor Changes</a>
     - <a href="#bugfixes-8">Bugfixes</a>
-- <a href="#v2-6-0">v2\.6\.0</a>
+- <a href="#v2-6-1">v2\.6\.1</a>
     - <a href="#release-summary-13">Release Summary</a>
-    - <a href="#minor-changes-10">Minor Changes</a>
     - <a href="#bugfixes-9">Bugfixes</a>
-- <a href="#v2-5-0">v2\.5\.0</a>
+- <a href="#v2-6-0">v2\.6\.0</a>
     - <a href="#release-summary-14">Release Summary</a>
+    - <a href="#minor-changes-10">Minor Changes</a>
+    - <a href="#bugfixes-10">Bugfixes</a>
+- <a href="#v2-5-0">v2\.5\.0</a>
+    - <a href="#release-summary-15">Release Summary</a>
     - <a href="#minor-changes-11">Minor Changes</a>
 - <a href="#v2-4-0">v2\.4\.0</a>
-    - <a href="#release-summary-15">Release Summary</a>
+    - <a href="#release-summary-16">Release Summary</a>
     - <a href="#minor-changes-12">Minor Changes</a>
     - <a href="#deprecated-features">Deprecated Features</a>
-    - <a href="#bugfixes-10">Bugfixes</a>
+    - <a href="#bugfixes-11">Bugfixes</a>
     - <a href="#known-issues">Known Issues</a>
 - <a href="#v2-3-1">v2\.3\.1</a>
-    - <a href="#release-summary-16">Release Summary</a>
-    - <a href="#bugfixes-11">Bugfixes</a>
-- <a href="#v2-3-0">v2\.3\.0</a>
     - <a href="#release-summary-17">Release Summary</a>
-    - <a href="#minor-changes-13">Minor Changes</a>
     - <a href="#bugfixes-12">Bugfixes</a>
-- <a href="#v2-2-0">v2\.2\.0</a>
+- <a href="#v2-3-0">v2\.3\.0</a>
     - <a href="#release-summary-18">Release Summary</a>
-    - <a href="#minor-changes-14">Minor Changes</a>
+    - <a href="#minor-changes-13">Minor Changes</a>
     - <a href="#bugfixes-13">Bugfixes</a>
-- <a href="#v2-1-0">v2\.1\.0</a>
+- <a href="#v2-2-0">v2\.2\.0</a>
     - <a href="#release-summary-19">Release Summary</a>
-    - <a href="#minor-changes-15">Minor Changes</a>
+    - <a href="#minor-changes-14">Minor Changes</a>
     - <a href="#bugfixes-14">Bugfixes</a>
-- <a href="#v2-0-0">v2\.0\.0</a>
+- <a href="#v2-1-0">v2\.1\.0</a>
     - <a href="#release-summary-20">Release Summary</a>
+    - <a href="#minor-changes-15">Minor Changes</a>
+    - <a href="#bugfixes-15">Bugfixes</a>
+- <a href="#v2-0-0">v2\.0\.0</a>
+    - <a href="#release-summary-21">Release Summary</a>
     - <a href="#major-changes">Major Changes</a>
     - <a href="#minor-changes-16">Minor Changes</a>
     - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
-    - <a href="#bugfixes-15">Bugfixes</a>
+    - <a href="#bugfixes-16">Bugfixes</a>
 - <a href="#v1-11-0">v1\.11\.0</a>
-    - <a href="#release-summary-21">Release Summary</a>
+    - <a href="#release-summary-22">Release Summary</a>
     - <a href="#minor-changes-17">Minor Changes</a>
 - <a href="#v1-10-0">v1\.10\.0</a>
-    - <a href="#release-summary-22">Release Summary</a>
+    - <a href="#release-summary-23">Release Summary</a>
     - <a href="#major-changes-1">Major Changes</a>
     - <a href="#minor-changes-18">Minor Changes</a>
-    - <a href="#bugfixes-16">Bugfixes</a>
+    - <a href="#bugfixes-17">Bugfixes</a>
 - <a href="#v1-9-0">v1\.9\.0</a>
-    - <a href="#release-summary-23">Release Summary</a>
+    - <a href="#release-summary-24">Release Summary</a>
     - <a href="#minor-changes-19">Minor Changes</a>
 - <a href="#v1-8-2">v1\.8\.2</a>
-    - <a href="#release-summary-24">Release Summary</a>
-    - <a href="#bugfixes-17">Bugfixes</a>
-- <a href="#v1-8-1">v1\.8\.1</a>
     - <a href="#release-summary-25">Release Summary</a>
     - <a href="#bugfixes-18">Bugfixes</a>
-- <a href="#v1-8-0">v1\.8\.0</a>
+- <a href="#v1-8-1">v1\.8\.1</a>
     - <a href="#release-summary-26">Release Summary</a>
-    - <a href="#minor-changes-20">Minor Changes</a>
     - <a href="#bugfixes-19">Bugfixes</a>
-- <a href="#v1-7-4">v1\.7\.4</a>
+- <a href="#v1-8-0">v1\.8\.0</a>
     - <a href="#release-summary-27">Release Summary</a>
+    - <a href="#minor-changes-20">Minor Changes</a>
     - <a href="#bugfixes-20">Bugfixes</a>
-- <a href="#v1-7-3">v1\.7\.3</a>
+- <a href="#v1-7-4">v1\.7\.4</a>
     - <a href="#release-summary-28">Release Summary</a>
     - <a href="#bugfixes-21">Bugfixes</a>
-- <a href="#v1-7-2">v1\.7\.2</a>
+- <a href="#v1-7-3">v1\.7\.3</a>
     - <a href="#release-summary-29">Release Summary</a>
     - <a href="#bugfixes-22">Bugfixes</a>
-- <a href="#v1-7-1">v1\.7\.1</a>
+- <a href="#v1-7-2">v1\.7\.2</a>
     - <a href="#release-summary-30">Release Summary</a>
     - <a href="#bugfixes-23">Bugfixes</a>
-- <a href="#v1-7-0">v1\.7\.0</a>
+- <a href="#v1-7-1">v1\.7\.1</a>
     - <a href="#release-summary-31">Release Summary</a>
-    - <a href="#minor-changes-21">Minor Changes</a>
     - <a href="#bugfixes-24">Bugfixes</a>
-- <a href="#v1-6-1">v1\.6\.1</a>
+- <a href="#v1-7-0">v1\.7\.0</a>
     - <a href="#release-summary-32">Release Summary</a>
+    - <a href="#minor-changes-21">Minor Changes</a>
     - <a href="#bugfixes-25">Bugfixes</a>
-- <a href="#v1-6-0">v1\.6\.0</a>
+- <a href="#v1-6-1">v1\.6\.1</a>
     - <a href="#release-summary-33">Release Summary</a>
-    - <a href="#minor-changes-22">Minor Changes</a>
     - <a href="#bugfixes-26">Bugfixes</a>
-- <a href="#v1-5-0">v1\.5\.0</a>
+- <a href="#v1-6-0">v1\.6\.0</a>
     - <a href="#release-summary-34">Release Summary</a>
-    - <a href="#minor-changes-23">Minor Changes</a>
+    - <a href="#minor-changes-22">Minor Changes</a>
     - <a href="#bugfixes-27">Bugfixes</a>
-- <a href="#v1-4-0">v1\.4\.0</a>
+- <a href="#v1-5-0">v1\.5\.0</a>
     - <a href="#release-summary-35">Release Summary</a>
-    - <a href="#minor-changes-24">Minor Changes</a>
+    - <a href="#minor-changes-23">Minor Changes</a>
     - <a href="#bugfixes-28">Bugfixes</a>
-- <a href="#v1-3-0">v1\.3\.0</a>
+- <a href="#v1-4-0">v1\.4\.0</a>
     - <a href="#release-summary-36">Release Summary</a>
-    - <a href="#minor-changes-25">Minor Changes</a>
+    - <a href="#minor-changes-24">Minor Changes</a>
     - <a href="#bugfixes-29">Bugfixes</a>
-- <a href="#v1-2-2">v1\.2\.2</a>
+- <a href="#v1-3-0">v1\.3\.0</a>
     - <a href="#release-summary-37">Release Summary</a>
+    - <a href="#minor-changes-25">Minor Changes</a>
     - <a href="#bugfixes-30">Bugfixes</a>
-- <a href="#v1-2-1">v1\.2\.1</a>
+- <a href="#v1-2-2">v1\.2\.2</a>
     - <a href="#release-summary-38">Release Summary</a>
     - <a href="#bugfixes-31">Bugfixes</a>
-- <a href="#v1-2-0">v1\.2\.0</a>
+- <a href="#v1-2-1">v1\.2\.1</a>
     - <a href="#release-summary-39">Release Summary</a>
-    - <a href="#minor-changes-26">Minor Changes</a>
     - <a href="#bugfixes-32">Bugfixes</a>
-- <a href="#v1-1-0">v1\.1\.0</a>
+- <a href="#v1-2-0">v1\.2\.0</a>
     - <a href="#release-summary-40">Release Summary</a>
+    - <a href="#minor-changes-26">Minor Changes</a>
+    - <a href="#bugfixes-33">Bugfixes</a>
+- <a href="#v1-1-0">v1\.1\.0</a>
+    - <a href="#release-summary-41">Release Summary</a>
     - <a href="#minor-changes-27">Minor Changes</a>
 - <a href="#v1-0-1">v1\.0\.1</a>
-    - <a href="#release-summary-41">Release Summary</a>
-    - <a href="#bugfixes-33">Bugfixes</a>
-- <a href="#v1-0-0">v1\.0\.0</a>
     - <a href="#release-summary-42">Release Summary</a>
+    - <a href="#bugfixes-34">Bugfixes</a>
+- <a href="#v1-0-0">v1\.0\.0</a>
+    - <a href="#release-summary-43">Release Summary</a>
     - <a href="#major-changes-2">Major Changes</a>
     - <a href="#minor-changes-28">Minor Changes</a>
 - <a href="#v0-1-0">v0\.1\.0</a>
-    - <a href="#release-summary-43">Release Summary</a>
+    - <a href="#release-summary-44">Release Summary</a>
 
-<a id="v2-16-1"></a>
-## v2\.16\.1
+<a id="v2-16-2"></a>
+## v2\.16\.2
 
 <a id="release-summary"></a>
 ### Release Summary
@@ -171,12 +174,25 @@ Bugfix release\.
 <a id="bugfixes"></a>
 ### Bugfixes
 
+* Fix role section heading levels\. Examples and attributes should be below role entrypoints \([https\://github\.com/ansible\-community/antsibull\-docs/issues/366](https\://github\.com/ansible\-community/antsibull\-docs/issues/366)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/367](https\://github\.com/ansible\-community/antsibull\-docs/pull/367)\)\.
+
+<a id="v2-16-1"></a>
+## v2\.16\.1
+
+<a id="release-summary-1"></a>
+### Release Summary
+
+Bugfix release\.
+
+<a id="bugfixes-1"></a>
+### Bugfixes
+
 * Also consider action plugin redirects/deprecations in runtime metadata for modules\, since for users there is no difference\. Also <code>ansible\.builtin\.yum</code> only has a action plugin redirect to <code>ansible\.builtin\.dnf</code>\, so this is needed to ensure that a stub page generated for <code>ansible\.builtin\.yum</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/360](https\://github\.com/ansible\-community/antsibull\-docs/pull/360)\)\.
 
 <a id="v2-16-0"></a>
 ## v2\.16\.0
 
-<a id="release-summary-1"></a>
+<a id="release-summary-2"></a>
 ### Release Summary
 
 Feature release\.
@@ -191,7 +207,7 @@ Feature release\.
 <a id="v2-15-0"></a>
 ## v2\.15\.0
 
-<a id="release-summary-2"></a>
+<a id="release-summary-3"></a>
 ### Release Summary
 
 Bugfix and feature release which migrates to Pydantic 2\.
@@ -209,7 +225,7 @@ Bugfix and feature release which migrates to Pydantic 2\.
 <a id="v2-14-0"></a>
 ## v2\.14\.0
 
-<a id="release-summary-3"></a>
+<a id="release-summary-4"></a>
 ### Release Summary
 
 Feature release\.
@@ -224,12 +240,12 @@ Feature release\.
 <a id="v2-13-1"></a>
 ## v2\.13\.1
 
-<a id="release-summary-4"></a>
+<a id="release-summary-5"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-1"></a>
+<a id="bugfixes-2"></a>
 ### Bugfixes
 
 * The output filename used by the <code>plugin</code> subcommand contained two dots before the <code>rst</code> extension \([https\://github\.com/ansible\-community/antsibull\-docs/issues/317](https\://github\.com/ansible\-community/antsibull\-docs/issues/317)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/318](https\://github\.com/ansible\-community/antsibull\-docs/pull/318)\)\.
@@ -237,7 +253,7 @@ Bugfix release\.
 <a id="v2-13-0"></a>
 ## v2\.13\.0
 
-<a id="release-summary-5"></a>
+<a id="release-summary-6"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -253,7 +269,7 @@ Bugfix and feature release\.
 * Remove superfluous whitespace or escaped spaces from templates \([https\://github\.com/ansible\-community/antsibull\-docs/pull/313](https\://github\.com/ansible\-community/antsibull\-docs/pull/313)\)\.
 * Remove trailing whitespace and leading and trailing empty lines from rendered templates\, and ensure they end with a newline if not empty \([https\://github\.com/ansible\-community/antsibull\-docs/pull/314](https\://github\.com/ansible\-community/antsibull\-docs/pull/314)\)\.
 
-<a id="bugfixes-2"></a>
+<a id="bugfixes-3"></a>
 ### Bugfixes
 
 * Fix RST escaping of the title in the collections per namespace list\. This causes a space to vanish between namespace name and the word <code>Namespace</code> with newer versions of antsibull\-docs\-parser \([https\://github\.com/ansible\-community/antsibull\-docs/pull/311](https\://github\.com/ansible\-community/antsibull\-docs/pull/311)\)\.
@@ -261,7 +277,7 @@ Bugfix and feature release\.
 <a id="v2-12-0"></a>
 ## v2\.12\.0
 
-<a id="release-summary-6"></a>
+<a id="release-summary-7"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -274,7 +290,7 @@ Bugfix and feature release\.
 * The <code>lint\-collection\-docs</code> subcommand will now complain about unchanged default values in <code>docs/docsite/links\.yml</code> taken from the [community collection template](https\://github\.com/ansible\-collections/collection\_template/) \([https\://github\.com/ansible\-community/antsibull\-docs/issues/273](https\://github\.com/ansible\-community/antsibull\-docs/issues/273)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/277](https\://github\.com/ansible\-community/antsibull\-docs/pull/277)\)\.
 * The collection docs linter now reports empty markup\, like <code>I\(\)</code>\, <code>L\(\,https\://example\.com\)</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/292](https\://github\.com/ansible\-community/antsibull\-docs/pull/292)\)\.
 
-<a id="bugfixes-3"></a>
+<a id="bugfixes-4"></a>
 ### Bugfixes
 
 * Improve handling of empty markup parameters for RST \([https\://github\.com/ansible\-community/antsibull\-docs/pull/290](https\://github\.com/ansible\-community/antsibull\-docs/pull/290)\)\.
@@ -285,7 +301,7 @@ Bugfix and feature release\.
 <a id="v2-11-0"></a>
 ## v2\.11\.0
 
-<a id="release-summary-7"></a>
+<a id="release-summary-8"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -295,7 +311,7 @@ Feature and bugfix release\.
 
 * Support examples for role entrypoints \([https\://github\.com/ansible\-community/antsibull\-docs/pull/244](https\://github\.com/ansible\-community/antsibull\-docs/pull/244)\)\.
 
-<a id="bugfixes-4"></a>
+<a id="bugfixes-5"></a>
 ### Bugfixes
 
 * Fix handling of <code>choices</code> that are dictionaries for <code>type\=list</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/276](https\://github\.com/ansible\-community/antsibull\-docs/pull/276)\)\.
@@ -304,7 +320,7 @@ Feature and bugfix release\.
 <a id="v2-10-0"></a>
 ## v2\.10\.0
 
-<a id="release-summary-8"></a>
+<a id="release-summary-9"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -314,7 +330,7 @@ Bugfix and feature release\.
 
 * It is now possible to render the collection changelog as part of the collection docsite by using the <code>changelog</code> option in <code>docs/docsite/config\.yml</code> \([https\://github\.com/ansible\-community/antsibull\-docs/issues/31](https\://github\.com/ansible\-community/antsibull\-docs/issues/31)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/267](https\://github\.com/ansible\-community/antsibull\-docs/pull/267)\)\.
 
-<a id="bugfixes-5"></a>
+<a id="bugfixes-6"></a>
 ### Bugfixes
 
 * Fix internal links to options and return values in simplified RST output \([https\://github\.com/ansible\-community/antsibull\-docs/pull/269](https\://github\.com/ansible\-community/antsibull\-docs/pull/269)\)\.
@@ -323,7 +339,7 @@ Bugfix and feature release\.
 <a id="v2-9-0"></a>
 ## v2\.9\.0
 
-<a id="release-summary-9"></a>
+<a id="release-summary-10"></a>
 ### Release Summary
 
 Maintenance release\.
@@ -336,7 +352,7 @@ Maintenance release\.
 <a id="v2-8-0"></a>
 ## v2\.8\.0
 
-<a id="release-summary-10"></a>
+<a id="release-summary-11"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -349,7 +365,7 @@ Bugfix and feature release\.
 * Declare support for Python 3\.12 \([https\://github\.com/ansible\-community/antsibull\-docs/pull/255](https\://github\.com/ansible\-community/antsibull\-docs/pull/255)\)\.
 * The colors used by the CSS provided by the Antsibull Sphinx extension can now be overridden \([https\://github\.com/ansible\-community/antsibull\-docs/pull/254](https\://github\.com/ansible\-community/antsibull\-docs/pull/254)\)\.
 
-<a id="bugfixes-6"></a>
+<a id="bugfixes-7"></a>
 ### Bugfixes
 
 * Fix duplicate docs detection \(for aliases\) for latest ansible\-core devel \([https\://github\.com/ansible\-community/antsibull\-docs/pull/257](https\://github\.com/ansible\-community/antsibull\-docs/pull/257)\)\.
@@ -357,7 +373,7 @@ Bugfix and feature release\.
 <a id="v2-7-0"></a>
 ## v2\.7\.0
 
-<a id="release-summary-11"></a>
+<a id="release-summary-12"></a>
 ### Release Summary
 
 Bugfix and refactoring release\.
@@ -367,7 +383,7 @@ Bugfix and refactoring release\.
 
 * Explicitly set up Galaxy context instead of relying on deprecated functionality \([https\://github\.com/ansible\-community/antsibull\-docs/pull/234](https\://github\.com/ansible\-community/antsibull\-docs/pull/234)\)\.
 
-<a id="bugfixes-7"></a>
+<a id="bugfixes-8"></a>
 ### Bugfixes
 
 * Fix schema for <code>seealso</code> in role entrypoints\. Plugin references now work \([https\://github\.com/ansible\-community/antsibull\-docs/issues/237](https\://github\.com/ansible\-community/antsibull\-docs/issues/237)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/240](https\://github\.com/ansible\-community/antsibull\-docs/pull/240)\)\.
@@ -378,12 +394,12 @@ Bugfix and refactoring release\.
 <a id="v2-6-1"></a>
 ## v2\.6\.1
 
-<a id="release-summary-12"></a>
+<a id="release-summary-13"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-8"></a>
+<a id="bugfixes-9"></a>
 ### Bugfixes
 
 * For role argument specs\, allow <code>author</code>\, <code>description</code>\, and <code>todo</code> to be a string instead of a list of strings\, similarly as with ansible\-doc and with modules and plugins \([https\://github\.com/ansible\-community/antsibull\-docs/pull/227](https\://github\.com/ansible\-community/antsibull\-docs/pull/227)\)\.
@@ -392,7 +408,7 @@ Bugfix release\.
 <a id="v2-6-0"></a>
 ## v2\.6\.0
 
-<a id="release-summary-13"></a>
+<a id="release-summary-14"></a>
 ### Release Summary
 
 Fix parsing of <code>EXAMPLES</code> and improve error message
@@ -402,7 +418,7 @@ Fix parsing of <code>EXAMPLES</code> and improve error message
 
 * Improve error messages when calls to <code>ansible\-doc</code> fail \([https\://github\.com/ansible\-community/antsibull\-docs/pull/223](https\://github\.com/ansible\-community/antsibull\-docs/pull/223)\)\.
 
-<a id="bugfixes-9"></a>
+<a id="bugfixes-10"></a>
 ### Bugfixes
 
 * When <code>EXAMPLES</code> has the format specified by <code>\# fmt\: \<format\></code>\, this value is used to determine the code block type \([https\://github\.com/ansible\-community/antsibull\-docs/pull/225](https\://github\.com/ansible\-community/antsibull\-docs/pull/225)\)\.
@@ -410,7 +426,7 @@ Fix parsing of <code>EXAMPLES</code> and improve error message
 <a id="v2-5-0"></a>
 ## v2\.5\.0
 
-<a id="release-summary-14"></a>
+<a id="release-summary-15"></a>
 ### Release Summary
 
 Release to support the updated Ansible Galaxy codebase\.
@@ -423,7 +439,7 @@ Release to support the updated Ansible Galaxy codebase\.
 <a id="v2-4-0"></a>
 ## v2\.4\.0
 
-<a id="release-summary-15"></a>
+<a id="release-summary-16"></a>
 ### Release Summary
 
 Bugfix and feature release\. Improves support for other builders than <code>html</code>\.
@@ -456,7 +472,7 @@ That release will only adjust the URLs to Galaxy\, except potentially bugfixes\.
 
 * The <code>\-\-use\-html\-blobs</code> feature that inserts HTML blobs for the options and return value tables for the <code>ansible\-docsite</code> output format is deprecated and will be removed soon\. The HTML tables cause several features to break\, such as references to options and return values\. If you think this feature needs to stay\, please create an issue in the [antsibull\-docs repository](https\://github\.com/ansible\-community/antsibull\-docs/issues/) and provide good reasons for it \([https\://github\.com/ansible\-community/antsibull\-docs/pull/217](https\://github\.com/ansible\-community/antsibull\-docs/pull/217)\)\.
 
-<a id="bugfixes-10"></a>
+<a id="bugfixes-11"></a>
 ### Bugfixes
 
 * Document and ensure that the <code>collection</code> subcommand with <code>\-\-use\-current</code> can only be used with collection names \([https\://github\.com/ansible\-community/antsibull\-docs/pull/214](https\://github\.com/ansible\-community/antsibull\-docs/pull/214)\)\.
@@ -475,12 +491,12 @@ That release will only adjust the URLs to Galaxy\, except potentially bugfixes\.
 <a id="v2-3-1"></a>
 ## v2\.3\.1
 
-<a id="release-summary-16"></a>
+<a id="release-summary-17"></a>
 ### Release Summary
 
 Bugfix release with a CSS fix for the Sphinx extension\.
 
-<a id="bugfixes-11"></a>
+<a id="bugfixes-12"></a>
 ### Bugfixes
 
 * Fix antsibull Sphinx extension CSS so that the option/return value anchors for module/plugin/role documentation can also be used on WebKit\-based browsers such as Gnome Web and Safari \([https\://github\.com/ansible\-community/antsibull\-docs/issues/188](https\://github\.com/ansible\-community/antsibull\-docs/issues/188)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/189](https\://github\.com/ansible\-community/antsibull\-docs/pull/189)\)\.
@@ -488,7 +504,7 @@ Bugfix release with a CSS fix for the Sphinx extension\.
 <a id="v2-3-0"></a>
 ## v2\.3\.0
 
-<a id="release-summary-17"></a>
+<a id="release-summary-18"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -503,7 +519,7 @@ Bugfix and feature release\.
 * Use Dart sass compiler instead of sassc to compile CSS for Sphinx extension \([https\://github\.com/ansible\-community/antsibull\-docs/issues/185](https\://github\.com/ansible\-community/antsibull\-docs/issues/185)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/186](https\://github\.com/ansible\-community/antsibull\-docs/pull/186)\)\.
 * When parsing errors happen in the Sphinx extension\, the extension now emits error messages during the build process in addition to error markup \([https\://github\.com/ansible\-community/antsibull\-docs/pull/187](https\://github\.com/ansible\-community/antsibull\-docs/pull/187)\)\.
 
-<a id="bugfixes-12"></a>
+<a id="bugfixes-13"></a>
 ### Bugfixes
 
 * Consider module/plugin aliases when linting references to other modules and plugins \([https\://github\.com/ansible\-community/antsibull\-docs/pull/184](https\://github\.com/ansible\-community/antsibull\-docs/pull/184)\)\.
@@ -513,7 +529,7 @@ Bugfix and feature release\.
 <a id="v2-2-0"></a>
 ## v2\.2\.0
 
-<a id="release-summary-18"></a>
+<a id="release-summary-19"></a>
 ### Release Summary
 
 Bugfix and feature release improving rendering and linting\.
@@ -524,7 +540,7 @@ Bugfix and feature release improving rendering and linting\.
 * Collection docs linter \- also validate <code>seealso</code> module and plugin destinations \([https\://github\.com/ansible\-community/antsibull\-docs/issues/168](https\://github\.com/ansible\-community/antsibull\-docs/issues/168)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/171](https\://github\.com/ansible\-community/antsibull\-docs/pull/171)\)\.
 * When linting collection plugin docs\, make sure that array stubs <code>\[\.\.\.\]</code> are used when referencing sub\-options or sub\-return values inside lists\, and are not used outside lists and dictionaries \([https\://github\.com/ansible\-community/antsibull\-docs/pull/173](https\://github\.com/ansible\-community/antsibull\-docs/pull/173)\)\.
 
-<a id="bugfixes-13"></a>
+<a id="bugfixes-14"></a>
 ### Bugfixes
 
 * Fix the way the Sphinx extension creates nodes for options and return values so they look identical for internal references\, external \(intersphinx\) references\, and unresolved references \([https\://github\.com/ansible\-community/antsibull\-docs/pull/175](https\://github\.com/ansible\-community/antsibull\-docs/pull/175)\)\.
@@ -535,7 +551,7 @@ Bugfix and feature release improving rendering and linting\.
 <a id="v2-1-0"></a>
 ## v2\.1\.0
 
-<a id="release-summary-19"></a>
+<a id="release-summary-20"></a>
 ### Release Summary
 
 Feature and bugfix release with many improvements related to semantic markup and validation\.
@@ -552,7 +568,7 @@ Feature and bugfix release with many improvements related to semantic markup and
 * When linting semantic markup in collection docs\, also accept aliases when checking <code>O\(\)</code> values \([https\://github\.com/ansible\-community/antsibull\-docs/pull/155](https\://github\.com/ansible\-community/antsibull\-docs/pull/155)\)\.
 * When refering to markup in multi\-paragraph texts\, like <code>description</code>\, now includes the paragraph number in error messages \([https\://github\.com/ansible\-community/antsibull\-docs/pull/163](https\://github\.com/ansible\-community/antsibull\-docs/pull/163)\)\.
 
-<a id="bugfixes-14"></a>
+<a id="bugfixes-15"></a>
 ### Bugfixes
 
 * Allow role entrypoint deprecations without having to specify the collection the role is removed from \([https\://github\.com/ansible\-community/antsibull\-docs/pull/156](https\://github\.com/ansible\-community/antsibull\-docs/pull/156)\)\.
@@ -562,7 +578,7 @@ Feature and bugfix release with many improvements related to semantic markup and
 <a id="v2-0-0"></a>
 ## v2\.0\.0
 
-<a id="release-summary-20"></a>
+<a id="release-summary-21"></a>
 ### Release Summary
 
 Major new release that drops support for older Python and Ansible/ansible\-base/ansible\-core versions\.
@@ -593,7 +609,7 @@ Major new release that drops support for older Python and Ansible/ansible\-base/
 * No longer supports Ansible 2\.9\, ansible\-base 2\.10\, and ansible\-core 2\.11 and 2\.12\. The minimum required ansible\-core version is 2\.13\. This allows for simpler and more efficient docs parsing and information retrieval \([https\://github\.com/ansible\-community/antsibull\-docs/pull/120](https\://github\.com/ansible\-community/antsibull\-docs/pull/120)\)\.
 * The <code>ansible\-doc</code> and <code>ansible\-internal</code> values for <code>doc\_parsing\_backend</code> in the configuration file have been removed\. Change the value to <code>auto</code> for best compatibility \([https\://github\.com/ansible\-community/antsibull\-docs/pull/120](https\://github\.com/ansible\-community/antsibull\-docs/pull/120)\)\.
 
-<a id="bugfixes-15"></a>
+<a id="bugfixes-16"></a>
 ### Bugfixes
 
 * Bump version range of antsibull\-docs requirement written by <code>sphinx\-init</code> subcommand to <code>\>\= 2\.0\.0a2\, \< 3\.0\.0</code>\. Previously\, this was set to <code>\>\=2\.0\.0\, \<3\.0\.0</code> which could not be satisfied \([https\://github\.com/ansible\-community/antsibull\-docs/pull/149](https\://github\.com/ansible\-community/antsibull\-docs/pull/149)\)\.
@@ -602,7 +618,7 @@ Major new release that drops support for older Python and Ansible/ansible\-base/
 <a id="v1-11-0"></a>
 ## v1\.11\.0
 
-<a id="release-summary-21"></a>
+<a id="release-summary-22"></a>
 ### Release Summary
 
 Feature release\.
@@ -618,7 +634,7 @@ Feature release\.
 <a id="v1-10-0"></a>
 ## v1\.10\.0
 
-<a id="release-summary-22"></a>
+<a id="release-summary-23"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -634,7 +650,7 @@ Bugfix and feature release\.
 * Add a note about the ordering of positional and named parameter to the plugin page\. Also mention positional and keyword parameters for lookups \([https\://github\.com/ansible\-community/antsibull\-docs/pull/101](https\://github\.com/ansible\-community/antsibull\-docs/pull/101)\)\.
 * Update schema for roles argument spec to allow specifying attributes on the entrypoint level\. These are now also rendered when present \([https\://github\.com/ansible\-community/antsibull\-docs/pull/103](https\://github\.com/ansible\-community/antsibull\-docs/pull/103)\)\.
 
-<a id="bugfixes-16"></a>
+<a id="bugfixes-17"></a>
 ### Bugfixes
 
 * Explicitly declare the <code>sh</code> dependency and limit it to before 2\.0\.0\. Also explicitly declare the dependencies on <code>pydantic</code>\, <code>semantic\_version</code>\, <code>aiohttp</code>\, <code>twiggy</code>\, and <code>PyYAML</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/99](https\://github\.com/ansible\-community/antsibull\-docs/pull/99)\)\.
@@ -643,7 +659,7 @@ Bugfix and feature release\.
 <a id="v1-9-0"></a>
 ## v1\.9\.0
 
-<a id="release-summary-23"></a>
+<a id="release-summary-24"></a>
 ### Release Summary
 
 Feature release\.
@@ -657,12 +673,12 @@ Feature release\.
 <a id="v1-8-2"></a>
 ## v1\.8\.2
 
-<a id="release-summary-24"></a>
+<a id="release-summary-25"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-17"></a>
+<a id="bugfixes-18"></a>
 ### Bugfixes
 
 * Fix the new options <code>\-\-extra\-html\-context</code> and <code>\-\-extra\-html\-theme\-options</code> of the <code>sphinx\-init</code> subcommand \([https\://github\.com/ansible\-community/antsibull\-docs/pull/86](https\://github\.com/ansible\-community/antsibull\-docs/pull/86)\)\.
@@ -670,12 +686,12 @@ Bugfix release\.
 <a id="v1-8-1"></a>
 ## v1\.8\.1
 
-<a id="release-summary-25"></a>
+<a id="release-summary-26"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-18"></a>
+<a id="bugfixes-19"></a>
 ### Bugfixes
 
 * When creating toctrees for breadcrumbs\, place subtree for a plugin type in the plugin type\'s section \([https\://github\.com/ansible\-community/antsibull\-docs/pull/83](https\://github\.com/ansible\-community/antsibull\-docs/pull/83)\)\.
@@ -683,7 +699,7 @@ Bugfix release\.
 <a id="v1-8-0"></a>
 ## v1\.8\.0
 
-<a id="release-summary-26"></a>
+<a id="release-summary-27"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -700,7 +716,7 @@ Feature and bugfix release\.
 * The default <code>index\.rst</code> created by <code>antsibull\-docs sphinx\-init</code> includes the new environment variable index \([https\://github\.com/ansible\-community/antsibull\-docs/pull/80](https\://github\.com/ansible\-community/antsibull\-docs/pull/80)\)\.
 * Use correct markup \(<code>envvar</code> role\) for environment variables\. Compile an index of all environment variables used by plugins \([https\://github\.com/ansible\-community/antsibull\-docs/pull/73](https\://github\.com/ansible\-community/antsibull\-docs/pull/73)\)\.
 
-<a id="bugfixes-19"></a>
+<a id="bugfixes-20"></a>
 ### Bugfixes
 
 * Make sure that <code>build\.sh</code> created by the <code>sphinx\-init</code> subcommand sets proper permissions for antsibull\-docs on the <code>temp\-rst</code> directory it creates \([https\://github\.com/ansible\-community/antsibull\-docs/pull/79](https\://github\.com/ansible\-community/antsibull\-docs/pull/79)\)\.
@@ -708,12 +724,12 @@ Feature and bugfix release\.
 <a id="v1-7-4"></a>
 ## v1\.7\.4
 
-<a id="release-summary-27"></a>
+<a id="release-summary-28"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-20"></a>
+<a id="bugfixes-21"></a>
 ### Bugfixes
 
 * Removed <code>sphinx</code> restriction in <code>requirements\.txt</code> file created by <code>antsibull\-docs sphinx\-init</code> since the bug in <code>sphinx\-rtd\-theme</code> has been fixed \([https\://github\.com/ansible\-community/antsibull\-docs/pull/69](https\://github\.com/ansible\-community/antsibull\-docs/pull/69)\)\.
@@ -723,12 +739,12 @@ Bugfix release\.
 <a id="v1-7-3"></a>
 ## v1\.7\.3
 
-<a id="release-summary-28"></a>
+<a id="release-summary-29"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-21"></a>
+<a id="bugfixes-22"></a>
 ### Bugfixes
 
 * Fix rendering of the <code>action\_group</code> attribute \([https\://github\.com/ansible\-community/antsibull\-docs/pull/62](https\://github\.com/ansible\-community/antsibull\-docs/pull/62)\)\.
@@ -736,12 +752,12 @@ Bugfix release\.
 <a id="v1-7-2"></a>
 ## v1\.7\.2
 
-<a id="release-summary-29"></a>
+<a id="release-summary-30"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-22"></a>
+<a id="bugfixes-23"></a>
 ### Bugfixes
 
 * Fix <code>version\_added</code> processing for ansible\.builtin 0\.x to represent this as <code>Ansible 0\.x</code> instead of <code>ansible\-core 0\.x</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/61](https\://github\.com/ansible\-community/antsibull\-docs/pull/61)\)\.
@@ -749,12 +765,12 @@ Bugfix release\.
 <a id="v1-7-1"></a>
 ## v1\.7\.1
 
-<a id="release-summary-30"></a>
+<a id="release-summary-31"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-23"></a>
+<a id="bugfixes-24"></a>
 ### Bugfixes
 
 * Prevent crash during <code>stable</code> docsite build when <code>\_python</code> entry is present in deps file \([https\://github\.com/ansible\-community/antsibull\-docs/pull/57](https\://github\.com/ansible\-community/antsibull\-docs/pull/57)\)\.
@@ -762,7 +778,7 @@ Bugfix release\.
 <a id="v1-7-0"></a>
 ## v1\.7\.0
 
-<a id="release-summary-31"></a>
+<a id="release-summary-32"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -778,7 +794,7 @@ Bugfix and feature release\.
 * Use <code>ansible \-\-version</code> to figure out ansible\-core version when ansible\-core is not installed for the same Python interpreter / venv that is used for antsibull\-docs \([https\://github\.com/ansible\-community/antsibull\-docs/pull/50](https\://github\.com/ansible\-community/antsibull\-docs/pull/50)\)\.
 * Use code formatting for all values\, such as choice entries\, defaults\, and samples \([https\://github\.com/ansible\-community/antsibull\-docs/issues/38](https\://github\.com/ansible\-community/antsibull\-docs/issues/38)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/42](https\://github\.com/ansible\-community/antsibull\-docs/pull/42)\)\.
 
-<a id="bugfixes-24"></a>
+<a id="bugfixes-25"></a>
 ### Bugfixes
 
 * Avoid long aliases list to make left column too wide \([https\://github\.com/ansible\-collections/amazon\.aws/issues/1101](https\://github\.com/ansible\-collections/amazon\.aws/issues/1101)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/54](https\://github\.com/ansible\-community/antsibull\-docs/pull/54)\)\.
@@ -787,12 +803,12 @@ Bugfix and feature release\.
 <a id="v1-6-1"></a>
 ## v1\.6\.1
 
-<a id="release-summary-32"></a>
+<a id="release-summary-33"></a>
 ### Release Summary
 
 Bugfix release for ansible\-core 2\.14\.
 
-<a id="bugfixes-25"></a>
+<a id="bugfixes-26"></a>
 ### Bugfixes
 
 * Fix formulation of top\-level <code>version\_added</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/43](https\://github\.com/ansible\-community/antsibull\-docs/pull/43)\)\.
@@ -800,7 +816,7 @@ Bugfix release for ansible\-core 2\.14\.
 <a id="v1-6-0"></a>
 ## v1\.6\.0
 
-<a id="release-summary-33"></a>
+<a id="release-summary-34"></a>
 ### Release Summary
 
 Bugfix and feature release\.
@@ -812,7 +828,7 @@ Bugfix and feature release\.
 * Use JSON serializer to format choices \([https\://github\.com/ansible\-community/antsibull\-docs/pull/37](https\://github\.com/ansible\-community/antsibull\-docs/pull/37)\)\.
 * Use special serializer to format INI values in examples \([https\://github\.com/ansible\-community/antsibull\-docs/pull/37](https\://github\.com/ansible\-community/antsibull\-docs/pull/37)\)\.
 
-<a id="bugfixes-26"></a>
+<a id="bugfixes-27"></a>
 ### Bugfixes
 
 * Avoid collection names with <code>\_</code> in them appear wrongly escaped in the HTML output \([https\://github\.com/ansible\-community/antsibull\-docs/pull/41](https\://github\.com/ansible\-community/antsibull\-docs/pull/41)\)\.
@@ -823,7 +839,7 @@ Bugfix and feature release\.
 <a id="v1-5-0"></a>
 ## v1\.5\.0
 
-<a id="release-summary-34"></a>
+<a id="release-summary-35"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -834,7 +850,7 @@ Feature and bugfix release\.
 * Detect filter and test plugin aliases and avoid them being emitted multiple times\. Instead insert redirects so that stub pages will be created \([https\://github\.com/ansible\-community/antsibull\-docs/pull/33](https\://github\.com/ansible\-community/antsibull\-docs/pull/33)\)\.
 * Replace <code>ansible\.builtin</code> with <code>ansible\-core</code>\, <code>ansible\-base</code>\, or <code>Ansible</code> in version added collection names\. Also write <code>\<collection\_name\> \<version\></code> instead of <code>\<version\> of \<collection\_name\></code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/34](https\://github\.com/ansible\-community/antsibull\-docs/pull/34)\)\.
 
-<a id="bugfixes-27"></a>
+<a id="bugfixes-28"></a>
 ### Bugfixes
 
 * Fix escaping of collection names in version added statements\, and fix collection names for roles options \([https\://github\.com/ansible\-community/antsibull\-docs/pull/34](https\://github\.com/ansible\-community/antsibull\-docs/pull/34)\)\.
@@ -842,7 +858,7 @@ Feature and bugfix release\.
 <a id="v1-4-0"></a>
 ## v1\.4\.0
 
-<a id="release-summary-35"></a>
+<a id="release-summary-36"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -854,7 +870,7 @@ Feature and bugfix release\.
 * There are two new options for explicitly specified configuration files named <code>collection\_url</code> and <code>collection\_install</code>\. These allow to override the URLs pointing to collections \(default link to galaxy\.ansible\.com\)\, and the commands to install collections \(use <code>ansible\-galaxy collection install</code> by default\)\. This can be useful when documenting \(internal\) collections that are not available on Ansible Galaxy\. The default <code>antsibull\-docs\.cfg</code> generated by the <code>sphinx\-init</code> subcommand shows how this can be configured \([https\://github\.com/ansible\-community/antsibull\-docs/issues/15](https\://github\.com/ansible\-community/antsibull\-docs/issues/15)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/26](https\://github\.com/ansible\-community/antsibull\-docs/pull/26)\)\.
 * When generating plugin error pages\, or showing non\-fatal errors in plugins or roles\, link to the collection\'s issue tracker instead of the collection\'s URL if available \([https\://github\.com/ansible\-community/antsibull\-docs/pull/29](https\://github\.com/ansible\-community/antsibull\-docs/pull/29)\)\.
 
-<a id="bugfixes-28"></a>
+<a id="bugfixes-29"></a>
 ### Bugfixes
 
 * Make handling of bad documentation more robust when certain values are <code>None</code> while the keys are present \([https\://github\.com/ansible\-community/antsibull\-docs/pull/32](https\://github\.com/ansible\-community/antsibull\-docs/pull/32)\)\.
@@ -862,7 +878,7 @@ Feature and bugfix release\.
 <a id="v1-3-0"></a>
 ## v1\.3\.0
 
-<a id="release-summary-36"></a>
+<a id="release-summary-37"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -876,7 +892,7 @@ Feature and bugfix release\.
 * Use <code>true</code> and <code>false</code> for booleans instead of <code>yes</code> and <code>no</code> \([https\://github\.com/ansible\-community/community\-topics/issues/116](https\://github\.com/ansible\-community/community\-topics/issues/116)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/19](https\://github\.com/ansible\-community/antsibull\-docs/pull/19)\)\.
 * When processing formatting directives\, make sure to properly escape all other text for RST respectively HTML instead of including it verbatim \([https\://github\.com/ansible\-community/antsibull\-docs/issues/21](https\://github\.com/ansible\-community/antsibull\-docs/issues/21)\, [https\://github\.com/ansible\-community/antsibull\-docs/pull/22](https\://github\.com/ansible\-community/antsibull\-docs/pull/22)\)\.
 
-<a id="bugfixes-29"></a>
+<a id="bugfixes-30"></a>
 ### Bugfixes
 
 * Improve indentation of HTML blocks for tables to avoid edge cases which generate invalid RST \([https\://github\.com/ansible\-community/antsibull\-docs/pull/22](https\://github\.com/ansible\-community/antsibull\-docs/pull/22)\)\.
@@ -884,12 +900,12 @@ Feature and bugfix release\.
 <a id="v1-2-2"></a>
 ## v1\.2\.2
 
-<a id="release-summary-37"></a>
+<a id="release-summary-38"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-30"></a>
+<a id="bugfixes-31"></a>
 ### Bugfixes
 
 * Fix rstcheck\-core support \([https\://github\.com/ansible\-community/antsibull\-docs/pull/20](https\://github\.com/ansible\-community/antsibull\-docs/pull/20)\)\.
@@ -897,12 +913,12 @@ Bugfix release\.
 <a id="v1-2-1"></a>
 ## v1\.2\.1
 
-<a id="release-summary-38"></a>
+<a id="release-summary-39"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-31"></a>
+<a id="bugfixes-32"></a>
 ### Bugfixes
 
 * Do not escape <code>\<</code>\, <code>\></code>\, <code>\&</code>\, and <code>\'</code> in JSONified defaults and examples as the [Jinja2 tojson filter](https\://jinja\.palletsprojects\.com/en/2\.11\.x/templates/\#tojson) does\. Also improve formatting by making sure <code>\,</code> is followed by a space \([https\://github\.com/ansible\-community/antsibull\-docs/pull/18](https\://github\.com/ansible\-community/antsibull\-docs/pull/18)\)\.
@@ -911,7 +927,7 @@ Bugfix release\.
 <a id="v1-2-0"></a>
 ## v1\.2\.0
 
-<a id="release-summary-39"></a>
+<a id="release-summary-40"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -923,7 +939,7 @@ Feature and bugfix release\.
 * The <code>lint\-collection\-docs</code> subcommand has a new boolean flag <code>\-\-plugin\-docs</code> which renders the plugin docs to RST and validates them with rstcheck\. This can be used as a lighter version of rendering the docsite in CI \([https\://github\.com/ansible\-community/antsibull\-docs/pull/12](https\://github\.com/ansible\-community/antsibull\-docs/pull/12)\)\.
 * The files in the source repository now follow the [REUSE Specification](https\://reuse\.software/spec/)\. The only exceptions are changelog fragments in <code>changelogs/fragments/</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/14](https\://github\.com/ansible\-community/antsibull\-docs/pull/14)\)\.
 
-<a id="bugfixes-32"></a>
+<a id="bugfixes-33"></a>
 ### Bugfixes
 
 * Make sure that <code>\_input</code> does not show up twice for test or filter arguments when the plugin mentions it in <code>positional</code> \([https\://github\.com/ansible\-community/antsibull\-docs/pull/10](https\://github\.com/ansible\-community/antsibull\-docs/pull/10)\)\.
@@ -932,7 +948,7 @@ Feature and bugfix release\.
 <a id="v1-1-0"></a>
 ## v1\.1\.0
 
-<a id="release-summary-40"></a>
+<a id="release-summary-41"></a>
 ### Release Summary
 
 Feature release with support for ansible\-core 2\.14\'s sidecar docs feature\.
@@ -949,12 +965,12 @@ Feature release with support for ansible\-core 2\.14\'s sidecar docs feature\.
 <a id="v1-0-1"></a>
 ## v1\.0\.1
 
-<a id="release-summary-41"></a>
+<a id="release-summary-42"></a>
 ### Release Summary
 
 Bugfix release\.
 
-<a id="bugfixes-33"></a>
+<a id="bugfixes-34"></a>
 ### Bugfixes
 
 * Make sure that aliases of module/plugin options and return values that result in identical RST labels under docutil\'s normalization are only emitted once \([https\://github\.com/ansible\-community/antsibull\-docs/pull/7](https\://github\.com/ansible\-community/antsibull\-docs/pull/7)\)\.
@@ -963,7 +979,7 @@ Bugfix release\.
 <a id="v1-0-0"></a>
 ## v1\.0\.0
 
-<a id="release-summary-42"></a>
+<a id="release-summary-43"></a>
 ### Release Summary
 
 First stable release\.
@@ -982,7 +998,7 @@ First stable release\.
 <a id="v0-1-0"></a>
 ## v0\.1\.0
 
-<a id="release-summary-43"></a>
+<a id="release-summary-44"></a>
 ### Release Summary
 
 Initial release\. The <code>antsibull\-docs</code> tool is compatible to the one from antsibull 0\.43\.0\.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index b1faea88..b5ce61b2 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -4,6 +4,19 @@ antsibull-docs -- Ansible Documentation Build Scripts Release Notes
 
 .. contents:: Topics
 
+v2.16.2
+=======
+
+Release Summary
+---------------
+
+Bugfix release.
+
+Bugfixes
+--------
+
+- Fix role section heading levels. Examples and attributes should be below role entrypoints (https://github.com/ansible-community/antsibull-docs/issues/366, https://github.com/ansible-community/antsibull-docs/pull/367).
+
 v2.16.1
 =======
 
diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml
index af407834..4d0d9139 100644
--- a/changelogs/changelog.yaml
+++ b/changelogs/changelog.yaml
@@ -981,3 +981,14 @@ releases:
       - 2.16.1.yml
       - 360-action-modules.yml
     release_date: '2024-11-21'
+  2.16.2:
+    changes:
+      bugfixes:
+        - Fix role section heading levels. Examples and attributes should be below
+          role entrypoints (https://github.com/ansible-community/antsibull-docs/issues/366,
+          https://github.com/ansible-community/antsibull-docs/pull/367).
+      release_summary: Bugfix release.
+    fragments:
+      - 2.16.2.yml
+      - 367-role-headings.yml
+    release_date: '2024-12-29'
diff --git a/changelogs/fragments/2.16.2.yml b/changelogs/fragments/2.16.2.yml
deleted file mode 100644
index 8ce9aa96..00000000
--- a/changelogs/fragments/2.16.2.yml
+++ /dev/null
@@ -1 +0,0 @@
-release_summary: Bugfix release.
diff --git a/changelogs/fragments/367-role-headings.yml b/changelogs/fragments/367-role-headings.yml
deleted file mode 100644
index 84f4a8ab..00000000
--- a/changelogs/fragments/367-role-headings.yml
+++ /dev/null
@@ -1,3 +0,0 @@
-bugfixes:
-  - "Fix role section heading levels. Examples and attributes should be below role entrypoints
-    (https://github.com/ansible-community/antsibull-docs/issues/366, https://github.com/ansible-community/antsibull-docs/pull/367)."