From bded47846ded1db1c0cb0fcc575dffd4d6f68a7b Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Sun, 4 Oct 2026 17:13:33 +0200 Subject: [PATCH] State the seed exception once, with pin-then-regenerate advice, and word --seed's help as the README's row --- README.md | 11 +++++------ cmd/fejkdata/main.go | 2 +- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index d77e181..75625d0 100644 --- a/README.md +++ b/README.md @@ -829,9 +829,11 @@ the output. Semver tags on `main`, `v0.1.0` first; one version covers the shipped data, the library and the CLI, and [`CHANGELOG.md`](CHANGELOG.md) names what each release -changed. A consumer's data, code and scripts keep working across a minor or a patch, -except output pinned to a seed. A minor only adds, and a major is the only release that -changes what exists. +changed. A consumer's data, code and scripts keep working across a minor or a patch. A +minor only adds, and a major is the only release that changes what exists. Seeded output +is the exception: any release, a patch too, may change what a seed draws. Where you +compare seeded output, install one exact version (`go install …@vX.Y.Z`; `go.mod` already +pins one), and regenerate seeded fixtures and expected values when you raise it. | Surface | Major | Minor | |---------|-------|-------| @@ -844,9 +846,6 @@ changes what exists. A patch changes no row of this table: performance, docs, or a fix inside a promised behaviour that adds or removes no value and changes no path, format or spelling. -Any release, a patch too, may change what a seed draws, so regenerate seeded fixtures -whenever the fejkdata version changes. - An error's wording may improve in a minor; the path, rejected spelling and replacement it names may not. diff --git a/cmd/fejkdata/main.go b/cmd/fejkdata/main.go index 49b621c..2299410 100644 --- a/cmd/fejkdata/main.go +++ b/cmd/fejkdata/main.go @@ -48,7 +48,7 @@ array, one JSON object per line, one CSV row (after a header), or one INSERT. --list list the paths the data offers, then exit --no-shipped-data load only the --data-path directories -n, --repeat N render the value N times, 1..1048576 (default 1) - -s, --seed N seed: the same seed, version and data give identical output + -s, --seed N same seed, version and data: identical output --separator S string between repeated values (default newline) --table T the INSERT target for --format sql (default: the path's last segment, or records for an inline template) --version print the version, then exit