From 5a731729f661620e92345f56099d4d316bc3be2d Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Wed, 30 Sep 2026 23:10:04 +0200 Subject: [PATCH] docs: raw/CONTRACT.md points at the path budget for a name accepted from incoming/ (#163) Files changed: - CHANGES.md - VERSION - raw/CONTRACT.md --- CHANGES.md | 9 ++++++++- VERSION | 2 +- raw/CONTRACT.md | 5 +++++ 3 files changed, 14 insertions(+), 2 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index 378ecb1..2b99fb7 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse. --- -## 8.0.0-beta.12 - 2026-09-30 - Path budget: a file's path stays at 160 characters or fewer so a Windows checkout works without long paths (#163) +## 8.0.0-beta.13 - 2026-09-30 - raw/CONTRACT.md points at the path budget for a name accepted from incoming/ **Author:** Torben Nehmer @@ -120,8 +120,15 @@ concern - readable here, never shipped as something to parse. - reports/CONTRACT.md: only the collector's two counting calls take the bugreport session id - bug-report instruction: step 1 no longer calls every bundle unpseudonymised - setup-instance step 15 names --no-push for a local-only first publish; gates.md and a docstring follow #159 +- raw/CONTRACT.md points at the path budget for a name accepted from incoming/ +### raw/CONTRACT.md points at the path budget for a name accepted from incoming/ + +The path budget's close-out review found the raw stage contract silent on it, although `raw +accept` now refuses a name that would put the file over it. `raw/CONTRACT.md` § Getting a file in +says so in one sentence and links the rule in `kb/CONTRACT.md` rather than restating it. + ### Path budget: a file's path stays at 160 characters or fewer so a Windows checkout works without long paths (#163) Windows counts 259 characters for a whole path, the install folder included, and the target system diff --git a/VERSION b/VERSION index 4209832..bb9ba9f 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -8.0.0-beta.12 +8.0.0-beta.13 diff --git a/raw/CONTRACT.md b/raw/CONTRACT.md index 6c930c3..4f55afb 100644 --- a/raw/CONTRACT.md +++ b/raw/CONTRACT.md @@ -74,6 +74,11 @@ tools/wikitool raw accept --fidelity verbatim --authority reporting incoming/han # -> raw/2026/09/handbuch.pdf ``` +The file's name becomes part of its path under `raw/`, and that path has the same budget as a +page's - [kb/CONTRACT.md § Titles are identifiers](../kb/CONTRACT.md#titles-are-identifiers). +`raw accept` refuses a target over it before anything moves; the fix is a shorter name in +`incoming/`. + **A bundle directory is created only from the second file onward.** One file promoted alone needs no directory of its own and lands as `raw///`; promoting several files of one source in the same call nests them under `raw////`, named after the first file's