docs: raw/CONTRACT.md points at the path budget for a name accepted from incoming/ (#163)
Files changed: - CHANGES.md - VERSION - raw/CONTRACT.md
This commit is contained in:
1 parent
04aebdeccf
commit
5a731729f6
3 files changed
+14
-2
No files matched your search
+8
-1
@@ -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
|
**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
|
- 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
|
- 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
|
- 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/
|
||||||
<!-- /wikitool:bumps -->
|
<!-- /wikitool:bumps -->
|
||||||
|
|
||||||
|
### 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)
|
### 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
|
Windows counts 259 characters for a whole path, the install folder included, and the target system
|
||||||
|
|||||||
@@ -74,6 +74,11 @@ tools/wikitool raw accept --fidelity verbatim --authority reporting incoming/han
|
|||||||
# -> raw/2026/09/handbuch.pdf
|
# -> 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
|
**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/<YYYY>/<MM>/<name>`; promoting several files of one
|
no directory of its own and lands as `raw/<YYYY>/<MM>/<name>`; promoting several files of one
|
||||||
source in the same call nests them under `raw/<YYYY>/<MM>/<stem>/`, named after the first file's
|
source in the same call nests them under `raw/<YYYY>/<MM>/<stem>/`, named after the first file's
|
||||||
|
|||||||
Reference in new issue
Block a user