Repository navigation
docs(i18n): document translator context hints in developer manual - #124
Merged
Merged
Conversation
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
6 tasks done
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.
Summary
Make LibreSign's Translation developer-manual page the canonical place for contributor guidance on source-string translations and
TRANSLATORShints.The LibreSign application PR #9364 previously added this detailed guidance to
CONTRIBUTING.md. This PR keeps the durable documentation in the documentation repository; #9364 will retain only a short link to this page and its existing automated lint safeguard.Changes
developer_manual/translation.rstpage, retaining its Transifex instructions.TRANSLATORSwithout a colon), where hints belong, when separate hints are needed, and why same-line conditional translations are ambiguous to the Nextcloud extractor.No translation catalog, generated Sphinx HTML, or screenshot images are committed to the repository.
Rendered documentation
Screenshots captured with Chromium/Playwright from the actual Sphinx-generated HTML of this branch:
Full Translation page — rendered output
Validation
sphinx-build -W developer_manual _build/developer_manual— passed, no warnings.git diff --check— passed.Cross-repository coordination: Review alongside LibreSign/libresign#9364, which will replace the duplicated
CONTRIBUTING.mdtutorial with a link to this page. No merge is requested as part of this PR.