From 13d622d57c8c7186f4a3c5257e51ef440fd06293 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Mon, 12 Oct 2026 17:19:09 +0200 Subject: [PATCH] Answer prose round 1: the shipped-data decision says its items ship in 0.2.0, the size gate says why it comes first, and item 89 says when New breaks again --- docs/decisions.md | 2 +- todo.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/decisions.md b/docs/decisions.md index 2e5cfa6..e1c5862 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -139,7 +139,7 @@ A directory a machine happens to have would make `--seed 42` machine-dependent; ## The shipped data is Go packages a library imports by choice, and the CLI carries every one, from 0.1.0 -2026-10-04, Lilleman auf Larv; revised 2026-10-09 to put the packages in the core's Go module. Serves goals 2.2, 6.2, 7.3, 9 and 10.1. Carried out by `todo.md` items 181, 186 and 196. The CLI binary may grow to hundreds of MB. +2026-10-04, Lilleman auf Larv; revised 2026-10-09 to put the packages in the core's Go module. Serves goals 2.2, 6.2, 7.3, 9 and 10.1. Carried out by `todo.md` items 181, 186 and 196, all in 0.2.0. The CLI binary may grow to hundreds of MB. - One Go package per locale, one per country's `geo` tree, and one for `misc`, all in the core's Go module. A package registers nothing when imported. - A bare `New()` loads no data and fails, naming the option to add. `WithoutShippedData` goes. diff --git a/todo.md b/todo.md index b595dbe..0ad95d5 100644 --- a/todo.md +++ b/todo.md @@ -220,7 +220,7 @@ ### 192. Fail the gate when the shipped data passes 100 MiB, naming item 193. -Carries out the decision "The shipped data is Go packages a library imports by choice, and the CLI carries every one, from 0.1.0", whose premise the maintainer set at 100 MiB on 2026-10-09: a fifth of the 500 MiB a Go module zip may hold. A test sums the bytes of the tracked files under `data/`. Items 202 to 205, 210 and 217, a locale each, grow them in 0.2.0. +Carries out the decision "The shipped data is Go packages a library imports by choice, and the CLI carries every one, from 0.1.0", whose premise the maintainer set at 100 MiB on 2026-10-09: a fifth of the 500 MiB a Go module zip may hold. A test sums the bytes of the tracked files under `data/`. Items 202 to 205, 210 and 217 each add a locale in 0.2.0, so the gate is in place before the data grows. ### 57. Rewrite `CHANGELOG.md`'s `[Unreleased]` as what v0.1.0 holds. @@ -548,7 +548,7 @@ NHTSA vPIC is public domain. The decision "`misc` is what every locale shares" p ### 89. Fail `New` without `WithSeed`, naming the option, and seed the CLI from the system. -Goal 10.1 has the caller supply the seed, and today `New` without `WithSeed` seeds itself. `New` already starts refusing a call naming no data in 0.1.0, so this breaks `New` a second time, which a minor before 1.0 allows. Mark `WithSeed` required in the Library section's options table. Its tests then stop swapping `randomBytes`, as `fejkdata_test.go` does today, which fails every `New` in the package while that test runs. +Goal 10.1 has the caller supply the seed, and today `New` without `WithSeed` seeds itself. `New` first refuses a call naming no data in 0.1.0, so this breaks `New` again in 0.2.0, which a minor before 1.0 allows. Mark `WithSeed` required in the Library section's options table. Its tests then stop swapping `randomBytes`, as `fejkdata_test.go` does today, which fails every `New` in the package while that test runs. ### 44. Have `misc.tld[se]` select the row keyed `.se`, or have its miss name `[.se]`.