Repository navigation
ci(i18n): gate pages, navigation and frontmatter across all languages - #1
Merged
Merged
Conversation
A page per language on installing a release from the browser: what the button does for each install method, the backup made first, the requirements, setting up Watchtower for Docker, and what to do when an install fails. The Updating page points to it, and its version check no longer uses the health endpoint, which returns only the status now.
check-docs-i18n.mjs fails when a language is missing a page that en has (or has one en lacks), when docs.json navigation drifts from en, when a title, description or page body is empty or left in English, or, given --since, when an en page changed without every translation changing with it. [i18n-skip] in a commit message overrides the last check for a deliberate en-only change. The CI workflow runs it on push and pull request; .githooks/pre-push runs it before every push and blocks the push on failure (activate with `git config core.hooksPath .githooks`). .gitattributes keeps the hook LF.
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
1 participant
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.
Summary
Adds an i18n gate for the docs so translations cannot silently drift from English.
.github/scripts/check-docs-i18n.mjsfails on:docs.jsonnavigation drift fromen--since:enpages changed without every translation changing (put[i18n-skip]in a commit message to override this last check).githooks/pre-pushblocks pushes when the check fails. Enable it withgit config core.hooksPath .githooks..gitattributeskeeps the hooks LF.