From a1c5a2d342485f53843650916ecfdd3f99d01e1f Mon Sep 17 00:00:00 2001
From: Felix Fontein <felix@fontein.de>
Date: Thu, 22 Jun 2023 07:02:40 +0200
Subject: [PATCH] Update release summary.

---
 changelogs/fragments/3.4.8.yml | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/changelogs/fragments/3.4.8.yml b/changelogs/fragments/3.4.8.yml
index 47d693b2..ddd71a96 100644
--- a/changelogs/fragments/3.4.8.yml
+++ b/changelogs/fragments/3.4.8.yml
@@ -1 +1,16 @@
-release_summary: Maintenance release with updated documentation.
+release_summary: |
+  Maintenance release with updated documentation.
+
+  From this version on, community.docker is using the new `Ansible semantic markup
+  <https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_documenting.html#semantic-markup-within-module-documentation>`__
+  in its documentation. If you look at documentation with the ansible-doc CLI tool
+  from ansible-core before 2.15, please note that it does not render the markup
+  correctly. You should be still able to read it in most cases, but you need
+  ansible-core 2.15 or later to see it as it is intended. Alternatively you can
+  look at `the devel docsite <https://docs.ansible.com/ansible/devel/collections/community/docker/>`__
+  for the rendered HTML version of the documentation of the latest release.
+known_issues:
+  - Ansible markup will show up in raw form on ansible-doc text output for ansible-core
+    before 2.15. If you have trouble deciphering the documentation markup, please
+    upgrade to ansible-core 2.15 (or newer), or read the HTML documentation on
+    https://docs.ansible.com/ansible/devel/collections/community/docker/.