From cd3fe394a582cdd8409e3e3de3f44bdb15c33422 Mon Sep 17 00:00:00 2001 From: Slavi Pantaleev Date: Fri, 25 Sep 2026 07:54:39 +0300 Subject: [PATCH] Explain changelog decisions in pull requests --- AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f9ed2b062..223a967c9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -29,6 +29,9 @@ An Ansible playbook that installs and manages a Matrix homeserver and dozens of The affected role's `tasks/validate_config.yml` should report routine variable renames or removals. Skip the changelog entry if that validation gives an actionable error. Correct any stale docs or examples instead. + When adding an entry, explain in the pull request why it is needed and what affected users must do. + For a Backward Compatibility entry, explain why validation alone cannot cover the change + and how the migration gate handles it. ## Conventions