docs(441): document language-file provenance refresh/preserve behaviour - #86
docs(441): document language-file provenance refresh/preserve behaviour#86wisdommen wants to merge 1 commit into
Conversation
…reserve behaviour - Bilingual (en/zh) i18n.md page: a new Provenance-based file refresh section explaining the four cases -- an untouched file is silently replaced by the current jar's copy with one INFO line; a customised file is left alone, with only individual keys whose String.format placeholder count moved resolved from the jar (a WARN naming module/file/key); and how an operator forces a refresh (delete the file, restart, framework re-extracts and re-baselines). - Marked v6.3.0. Prose and inline code only, no new compiled-example reference, no versionsConfig.current change. npm run build succeeds; container-length check reports 0 violations on both changed files. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018BUB3sHMAHm8bYVbLbTTKK
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Deploying ultitools-dev-doc with
|
| Latest commit: |
6f8b315
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://2179744a.ultitools-dev-doc.pages.dev |
| Branch Preview URL: | https://docs-phase-16-language-files.ultitools-dev-doc.pages.dev |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 6f8b315d9a
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| leaves your file alone. Only the individual keys whose `String.format` placeholder count | ||
| (`%s`, `%d`, or an explicit `%1$s` index) has changed between your file and the current jar | ||
| are resolved from the jar instead, each logged once as a WARN naming the module, file and key | ||
| -- your other keys keep your wording. |
There was a problem hiding this comment.
The newly added -- creates a pause before a supplemental clause, contrary to the English-locale writing rule. End the WARN sentence before explaining that the remaining keys retain their wording, or connect the clauses directly with “while.”
AGENTS.md reference: AGENTS.md:L27-L31
Useful? React with 👍 / 👎.
1 participant
Targets
alphadeliberately -- this documents unreleased 6.3.0 behaviour, not the currentlyreleased
masterlayer. Companion framework PR: UltiKits/UltiTools-Reborn#458 (alsoalpha).What changed
Bilingual
i18n.md(en + zh) gains one new section, "Provenance-based file refresh", explainingthe language-file provenance mechanism landing alongside #441:
lang/<code><ext>file is silently replaced by the current jar's bundled copy onthe module's next start, with one INFO line naming the file.
String.formatplaceholder count (
%s/%d, or an explicit%1$sindex) has moved between your file and thecurrent jar are resolved from the jar instead, with a WARN naming the module, file and key.
Marked "as of v6.3.0". No new
<<< @/../examples/...reference, noversionsConfig.current/examples/pom.xmlversion bump.Verification
npm run buildsucceeds.bash scripts/check-container-length.sh docs/src/guide/essentials/i18n.md docs/src/zh/guide/essentials/i18n.md-- 0 violations.file(1)/line-ending check before and after editing).🤖 Generated with Claude Code
https://claude.ai/code/session_018BUB3sHMAHm8bYVbLbTTKK