# 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. This follows the same convention as the
[posts](https://git.monoexp.com/bajdev/posts/src/main/pull-releases) repo.

```
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 own `public/` folder served locally,
before it is deployed, so they show exactly what the PR will put live:

```bash
python3 -m http.server 18005 --bind 127.0.0.1 --directory public &
screenshot-site http://127.0.0.1:18005/ pull-releases/NNN-branch-name
```

Folder names use lowercase letters, digits and hyphens only. Embed the
screenshots as `[![Desktop](desktop.png)](desktop.png)` so they link to the
full-size image. Extra captures, such as a dark-mode view, can sit alongside.

Unlike posts, this site has no version number and no release notes page:
the records live in the repo only.

| PR | Change |
|---|---|
| [001](001-home-page/) | Static home page, nginx vhost and setup README |