# Pull releases

One folder per pull request, so each change has a written record with
screenshots. The record is added on the PR's own branch, so it is reviewed and
merged with the change.

```
pull-releases/
  NNN-branch-name/      NNN = next number in sequence, branch name without feature/
    README.md           title (first line), what changed, notes, testing
    desktop.png         home page at 1280×900
    mobile.png          home page at 390×844 (2× pixel density)
```

To open the PR on Gogs, use the compare link for the branch, paste the first
line of `README.md` as the title and the rest as the description.

Screenshots are taken from the branch's build running locally, before it is
deployed, so they show exactly what the PR will put live.

The records are built into the app and published at `/releases` (linked from
the About page). The first line must be a `# Title` heading, and a
`version X.Y.Z` on the line below it is shown in the list. Embed the
screenshots as `[![Desktop](desktop.png)](desktop.png)` so they link to the
full-size image. A test fails if a folder is misnamed, is missing a
screenshot, or its `README.md` doesn't load.

| PR | Change |
|---|---|
| [001](001-initial/) | Markdown blog server |
| [002](002-header-about-config/) | About page, configurable Home link, RSS footer, MIT license |
| [003](003-css-cache-busting/) | Content hash on the stylesheet URL; this folder |
| [004](004-release-notes-page/) | Release notes pages on the site |
| [005](005-post-author/) | Author in the post header |
| [006](006-go-1-27/) | Require Go 1.27.3 (security fixes) |
| [007](007-pinned-posts/) | Pinned posts |