From d71056563df292a90fa862070fa0e9e6a85fc701 Mon Sep 17 00:00:00 2001 From: Thorsten Sommer Date: Fri, 18 Sep 2026 17:06:07 +0200 Subject: [PATCH] Updated changelog rules --- AGENTS.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 689a3f92..a143c86d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -344,3 +344,12 @@ following words: - Upgraded The entire changelog is sorted by these categories in the order shown above. The language used for the changelog is US English. + +**Every entry has to stand on its own.** Never refer back to another entry, neither by wording such +as "the same question", "that dialog", or "as described above", nor by relying on one read just +before it. Readers pick out the entries which concern them; an entry which only makes sense after +reading its neighbors turns the changelog into something nobody reads at all. Name the context +inside the entry instead, even when that repeats a few words from another one. + +**Split a topic into several short entries** rather than growing a single long one, and address the +reader with "you".