Repository navigation
TD-21: Translate the TechDocs content - #355
Draft
brianzelip wants to merge 6 commits into
Draft
brianzelip wants to merge 6 commits into
brianzelip wants to merge 6 commits into
Conversation
brianzelip
force-pushed
the
TD-21-enable-i18n
branch
from
July 31, 2026 15:58
2ecbad8 to
723804d
Compare
Deploying archivesspace-tech-docs with
|
| Latest commit: |
3277e18
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://ff37a79b.archivesspace-tech-docs.pages.dev |
| Branch Preview URL: | https://td-21-enable-i18n.archivesspace-tech-docs.pages.dev |
brianzelip
force-pushed
the
TD-21-enable-i18n
branch
from
November 16, 2026 15:17
4efcc09 to
9552c79
Compare
Add guardrails to the translation prompt, project doc, and glossary
based on committee feedback from the Dutch translation PR:
- The agent communicates with collaborators only in English; the
target language appears only in the translated page and that
language's glossary column. Translator notes are written in English.
- Each run edits only the target language's section of the glossary.
- A run changes only the translated page, the glossary, and that
language's notes log; collaborators check this before committing.
Also add src/content/docs/{nl,fr,de,ja,es,uk}/.gitkeep so each
language's content directory exists in the repo before any
translations are added, and update the project doc to match.
This branch has not been deployed
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.
What we need on our computers to carry out this work
What the output looks like from this workflow
The intended workflow for this project is to translate one file at a time from English into another language.
The output from this workflow is one translated file. Run the workflow X times to translate X different files.
Commit message should include
The actual steps we need to take
a.
{TARGET_LANGUAGE}, ie:SPANISHb.
{LOCALE_CODE}, ie:es(NOTE the lowercase!)c.
{RELATIVE_FILE_NAME}, ie:administration/backup.mda. the "shape" looks the same (frontmatter keys, headings, etc.)
b. things that should not be translated are not translated (file name, shell commands, etc.)