1
0

README.md 1.5 KB

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 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:

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 Static home page, nginx vhost and setup README
002 Canonical URL; HTTPS clone and working first-deploy command