changelog

Start with the version heading in the form ## [number] - YYYY-MM-DD, then add groups in Keep a Changelog order: Added, Changed, Removed, Fixed, Tests, Documentation. Each point names the changed thing as it appears on screen, states what it was, what it is now, and what follows for the user.

Write the English half first, then a line reading **Deutsch**, then the same points rethought in German rather than translated sentence by sentence. Both halves must hold the same number of points, and neither half may carry function words of the other language.

Exclude editorial tidying, measurement findings that changed nothing, and workshop-only work such as renamed tests, guidelines, comments, or function names. When in doubt, leave it out; a short section where every point says something beats a long one where they drown.

A Fixed point that only describes what was wrong is a bug report, not news. The reader needs the second half stating the current behavior, so they know the fault is gone and what to expect when they use the program.

Only if they cannot be mistaken for each other. Two numbers measuring different things in one point confuse readers; split them into separate points or express them in different units, and always include the setup a number needs to make sense.