Skip to content

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 ## Changed list.
  • 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.