Updated changelog rules

This commit is contained in:
Thorsten Sommer 2026-09-18 17:06:07 +02:00
parent 67cde060fb
commit d71056563d
Signed by untrusted user who does not match committer: tsommer
GPG Key ID: 371BBA77A02C0108

View File

@ -344,3 +344,12 @@ following words:
- Upgraded - Upgraded
The entire changelog is sorted by these categories in the order shown above. The language used for the changelog is US English. 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".