diff --git a/CHANGELOG.md b/CHANGELOG.md
index cfdc6bf..483134c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ## [Unreleased]
 
 ## [2.2.0] - 2026-09-28
-- Add **Vector › Parallelizer › Report a problem…**: a diagnostics report (versions, settings, last error, recent plugin log, and a description of the layers, project and features the failed or last operation worked on, with the rotation math for the last five operations; geometries only on request, moved to a local origin, with large references clipped around each target; Python stacks from a crash or a freeze in the previous session) you can review and edit, then copy, open as a pre-filled GitHub issue, open as a pre-filled email to the developer in your own mail app, or send with one click (**Send report**, no account needed) to the developer's private report service. See the privacy note on the docs site. Nothing is sent automatically. After an unexpected error, a message offers to open it. The plugin now also logs to the Log Messages panel (*Parallelizer* tab) and a small log file in the QGIS profile folder
+- Add "Report a problem..." (Vector > Parallelizer menu), also offered after an unexpected error. It shows a diagnostics report you can review and edit before sharing: versions, settings, the last error, recent log lines and a description of the last operations. Nothing is sent automatically
+- Share a report by copying it, opening a pre-filled GitHub issue, opening a pre-filled email, or with one click (Send report, no account needed) to the developer's private report service. See the privacy note on the docs site
+- Geometries are only included if you tick a box, and are moved to a local origin so their real location is not shared
+- After a crash or freeze, the next start offers to report it
+- The plugin now logs to the Log Messages panel (Parallelizer tab) and to a small log file in the QGIS profile folder
 
 ## [2.1.3] - 2026-09-27
 - Rename the plugin on the QGIS plugin portal to "Parallelizer: Align Polygons and Lines" and rewrite its description, about text and tags so it is easier to find
diff --git a/CLAUDE.md b/CLAUDE.md
index e73b633..e2b3370 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,7 +2,7 @@
 
 ## Project
 
-QGIS Processing plugin `PolygonsParallelToLine` (id `pptl`): rotates polygons and lines to be parallel to the nearest segment of a reference line or polygon layer. Distributed via the QGIS plugin portal. Releases are tag-driven via `.github/workflows/release.yaml`; `qgis-plugin-ci` patches `metadata.txt`'s `version=` and `changelog=` in the zip at build time. In-repo `version=` strings are placeholders (`0.0.0`).
+QGIS Processing plugin `PolygonsParallelToLine` (id `pptl`): rotates polygons and lines to be parallel to the nearest segment of a reference line or polygon layer. Distributed via the QGIS plugin portal. Releases are tag-driven via `.github/workflows/release.yaml`; `qgis-plugin-ci` patches `metadata.txt`'s `version=` and `changelog=` in the zip at build time. In-repo `version=` strings are placeholders (`0.0.0`). `CHANGELOG.md` entries end up as plain text on the plugin portal: short bullets, no Markdown formatting.
 
 ## Environment
 
diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index a347325..eb6121d 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -77,7 +77,7 @@ These instructions are specific to PyCharm.
 
 ## Releasing a New Plugin Version
 
-1. Make sure `CHANGELOG.md`'s `## [Unreleased]` section has the entries you want shipped, then on `main` with a clean working tree run:
+1. Make sure `CHANGELOG.md`'s `## [Unreleased]` section has the entries you want shipped. The plugin portal shows them as plain text, so write short bullets without Markdown formatting (no `**bold**`, `*italic*` or backticks). Then on `main` with a clean working tree run:
    ```shell
    make tag VERSION=X.Y.Z
    ```