larvit/fejkdata
3
0
Fork 0
Code Pull Requests Actions Activity

Record the release decisions and the work they set #11

Merged
lilleman merged 3 commits from release-decisions into main 2026-09-14 23:32:29 +02:00
Conversation 0 Commits 3 Files Changed 2
+13 -9
1 changed files with 13 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit c6cd816fe7 - Show all commits
todo.md
+13 -9
View File
@@ -1,6 +1,6 @@
# Release checklist
## Before the first release
## Before v0.1.0
The record API lands first, so the data update can use it.
@@ -35,18 +35,22 @@ The record API lands first, so the data update can use it.
- Major data update. Shipped categories render as records with their building
blocks as columns (`sv_SE.person` → `femalefirst`, `malefirst`; `misc.uuid` →
`variant`), and `sv_SE.address` draws its postal code apart from its locality.
- Decide what a version promises about shipped data: its paths, its record
columns, and whether a seed renders the same output across versions.
It also settles what a version promises about shipped data: its paths, its
record columns, and whether a seed renders the same output across versions.
- `email.local` and `username` share their handle lists, while their name
variants differ on purpose. Share the lists only if that is a clean win.
### Release
- Versioning — semver tags, `vX.Y.Z`. From v2 the module path carries `/vN`
(`go.mod`, imports, the README's install lines). Pick the first tag, and reword
the Decision "After the first tag, a new fence is a major version" to match.
- Changelog — a `## Changelog` section in the README, added with the first tag;
the fence Decision's "changelog" points there.
- Versioning — semver tags, starting at `v0.1.0`; `v1.0.0` once the grammar
settles. From v2 the module path carries `/vN` (`go.mod`, imports, the README's
install lines), so fences ship batched into as few majors as possible. Reword
the Decision "After the first tag, a new fence is a major version" to match:
before `v1.0.0` a fence ships in a minor.
- Changelog — `CHANGELOG.md`, started with `v0.1.0`; the fence Decision's
"changelog" links there.
- CLI without Go — investigate prebuilt binaries: GoReleaser publishing to Gitea
releases, a container image, Homebrew and Scoop.
- Homepage — a simple page for fejkdata.
- Homepage — a simple page for fejkdata with an in-browser generator: the library
compiled to WebAssembly, so visitors generate as much data as they like in their
own browser.