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

Answer product-owner round 1: the Data section names the geo trees, and Layout says what the docs records hold

Browse Source
This commit is contained in:
Lilleman auf Larv
2026-10-09 13:06:05 +02:00
committed by Lillem4n
parent 18a264db59
commit 0243e8d42d
1 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+6 -5
View File
@@ -161,10 +161,11 @@ it to a name and read the name
## Data ## Data
The shipped set under [`data/`](data) — one folder per locale (`en_US`, `sv_SE`), The shipped set under [`data/`](data) — one folder per locale (`en_US`, `sv_SE`),
a `geo` folder of each country's places, and a locale-neutral `misc` folder — is a `geo` folder holding a tree of places per country (`SE`, `US`), and a
embedded, so the CLI and the library work with no data on disk. A directory is a locale-neutral `misc` folder — is embedded, so the CLI and the library work with
namespace: each JSON file is a category named after the file, each subdirectory no data on disk. A directory is a namespace: each JSON file is a category named
a dot-path segment, so `mydata/sv_SE/person.json` is `sv_SE.person` and replaces the shipped one. after the file, each subdirectory a dot-path segment, so `mydata/sv_SE/person.json`
is `sv_SE.person` and replaces the shipped one.
Sources merge in order; matching folders combine, any other clash is won by the Sources merge in order; matching folders combine, any other clash is won by the
last loaded. Names may not use `.`, `|`, `(`, `{`, `}`, `[`, `]`, `"`, `/` or ` as `, last loaded. Names may not use `.`, `|`, `(`, `{`, `}`, `[`, `]`, `"`, `/` or ` as `,
which binds a [name](#names), nor be `-`, which a struct tag reserves. A dot-prefixed which binds a [name](#names), nor be `-`, which a struct tag reserves. A dot-prefixed
@@ -1017,7 +1018,7 @@ internal/proven/ what a proof knows of a value, and the bounds a calc takes from
internal/rows/ a table's rows: the TSV, the options proved over it, the links between tables, row selection and draws, and the pin set one path or one named pick fixes internal/rows/ a table's rows: the TSV, the options proved over it, the links between tables, row selection and draws, and the pin set one path or one named pick fixes
data/ shipped data (JSON, and a TSV per table), embedded at build: locale folders, geo, misc data/ shipped data (JSON, and a TSV per table), embedded at build: locale folders, geo, misc
data-import/ the scripts that rebuild each sourced table (see DATA-LICENSES.md), and the modules they share data-import/ the scripts that rebuild each sourced table (see DATA-LICENSES.md), and the modules they share
docs/ the decision log, the register research behind the shipped data, the survey of other libraries, and the comprehension and reading-cost records docs/ the decision log, the register research behind the shipped data, the survey of other libraries, panels' scores of how readable the code is, and what each change cost to read
release-tooling/ the release CI publishes from the changelog heading release-tooling/ the release CI publishes from the changelog heading
testdata/ the pinned shipped shape (see Versioning) testdata/ the pinned shipped shape (see Versioning)
``` ```