Repository navigation
Publish more reviewed documentation translations - #833
Merged
Merged
Conversation
Activate translations whose link dependencies are available and retain the remaining generated pages as pending data. Preserve CLI translations as pending because their English source changed. Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
Keep per-link source checks and raw reads while reusing the derived body only when the source text matches. Source edits reparse; each new pass starts empty. Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
Signed-off-by: zlareb1 <lareb.zafar@clickhouse.com>
9 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changelog category (leave one):
Changelog entry
Publish twelve reviewed documentation translations, correct one Korean translation and retain fourteen additional generated pages as pending data.
Why
Verified translations can publish once their translated link destinations exist. Four pages move unchanged from pending storage, and eight additional pages join them. A model-generated Korean replacement preserves the meaning of qualified names. Other translations wait for their dependencies or updated English sources.
The lifecycle checker parses the same English fallback source for each link. Each link-validation or repair pass reuses a derived body only when the source path and freshly read text match. This removes repeated parsing while retaining file checks, current reads and parser failures for every link.
Scope and risk
Generated Markdown across the five configured translation languages, plus the existing fallback helper and focused regression tests. The import validates source stamps, model, banners, protected content and dependency closure. Every changed body has an independent complete semantic and native-language review. Two CLI translations retain their original source stamps in pending storage because the English reference changed. Pending pages have no website routes.
Derived-body reuse is limited to one invocation. Changed text reparses; deleted or symlinked sources still fail the existing checks. No cache crosses invocations, and links without fragments still parse their source.
Compatibility, rollout and rollback
Tests
git diff --check: pass.AI assistance in the code (leave one; writing this description with AI is fine):
AI-generated (an agent wrote most of the diff): Codex prepared the lifecycle change and generated-data imports, and checked their validation results and independent reviews. Translation prose comes from the approved translation model.
I can explain every line of this diff and how it interacts with the rest of Loom.
Checklist