Changelog Per Version
Every version gets its own page in docs/records/changelog/<version>.md, listed newest on top in the wiki. Its list is a view the wiki generates from the tickets that landed in the version, so no builder appends to it and no conductor keeps it.
Why
A changelog says what a version holds: for testing it, for sharing it and for migrating to it.
The Page
- The H1 carries the DEV day as a suffix:
# 0.0.33 - DEV day 13, so the wiki's menu shows it. A page in progress carries the day it is being worked on, retitled the morning a new day starts on it, and the tag day at the close. - The header, kept by hand, names the tag date with its DEV day and, for an app that ships packages, whether this build was packaged.
- Under it, the generated list: every ticket that landed in the version, workspace tickets included, in landing order, each line its id and its link,
- FEAT-214: [Upload Retries After A Dropped Connection](/tickets/FEAT-214). - A ticket belongs to the version whose tag first holds its landing commit. One landed after the last tag lists under the version in progress.
- An in-game "What's New", where a game has one, shows the player-facing tickets alone, never the workspace's or a secret.
The DEV Day
- The DEV day counts the days with a commit, read from git, since the first day an agent worked on the project. The day turns at 04:00 local time, so a session past midnight stays on the day it started.
- Earlier days count as proof of concept (POC) days.
- Every dated record carries it: the log, the activity, the playtests, the user tests and the changelog.
Versions
- A version closes on the director's word, and the work merged since the last tag is its batch: the closing commit is tagged
v<version>. - The bump and the next page wait for the next version's first landing, which bumps the app and creates the page with its header.
- An unused version gets deleted.
Without Tickets
A project without tickets keeps the list through its append script.
- The page holds one
## Changedlist. - Every landing appends one line at the bottom, ending in its time:
- <what changed> `HH:MM`. - No line is written free hand.
- The script refuses a second bullet, a semicolon that chains two items, and a line without its time.