Repository navigation
Commit 4083936
committed
docs(i18n): state the shipped severity for an unresolvable translation key
`content/docs/protocol/kernel/i18n-standard.mdx` promised that an unresolvable
translation-bundle key "is a **warning**, not an error: nothing crashes". Both
halves are false against the shipped linter: `translation-target-unknown` has
carried `severity: 'error'` since #16310, so `os validate`, `os lint` and
`os compile` each exit non-zero on one. An author who read the page and then
wrote a locale key against a target the linter cannot resolve got a failed run,
having been told in writing it would be a nag.
The whole claim is repaired, not just the severity word:
- the severity now reads `error`, names the rule id so it can be grepped, and
names the three commands that exit non-zero on it;
- the runtime half ("nothing crashes ... renders in its source locale") is kept,
because it is still true and is precisely the reason the rule gates: the orphan
key stays a confident-looking grep hit for a surface that was deleted;
- the sibling rule is separated out, since the very next paragraph is about it:
`translation-option-key-unknown` is still a warning.
The linter is untouched by design. #16310 was a deliberate promotion, so the page
is what drifted.
Claude-Session: https://claude.ai/code/session_017ef78bLdybu3AffehKkhfk
Co-authored-by: Claude <noreply@anthropic.com>1 parent f1c9bb3 commit 4083936
1 file changed
Lines changed: 10 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1024 | 1024 | | |
1025 | 1025 | | |
1026 | 1026 | | |
1027 | | - | |
1028 | | - | |
1029 | | - | |
| 1027 | + | |
| 1028 | + | |
| 1029 | + | |
| 1030 | + | |
| 1031 | + | |
| 1032 | + | |
| 1033 | + | |
| 1034 | + | |
| 1035 | + | |
| 1036 | + | |
1030 | 1037 | | |
1031 | 1038 | | |
1032 | 1039 | | |
| |||
0 commit comments