Skip to content

Rewrite the localization teams docs to improve legibility, and explicitly permit members who know each other #12720

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
00-kat wants to merge 1 commit into
base: main
Choose a base branch
from
+25 −19
Open

Rewrite the localization teams docs to improve legibility, and explicitly permit members who know each other #12720

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 25 additions & 19 deletions po/README_TRANSLATORS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -160,25 +160,31 @@ the right click menu.

## Localization teams

Every locale has a localization team consisting of the locale's maintainers.
These maintainers review contributions to their locale's translations, and are
responsible for translating new strings when requested: occasionally, all locale
maintainers are pinged and requested to translate missing strings.

The primary purposes of being a locale maintainer are a declaration of
_commitment_ to their upkeep, and being _informed_ of updates or update requests
of the translations, via GitHub's review requests or @mentions.

So that future updates to a locale are possible, each localization team must
have at least two members. If you are introducing a new language, please
**consider volunteering** to be a part of the localization team, by mentioning
that you are willing to be a part of it in the pull request description! You,
and all reviewers, will be offered to join the locale team before the pull
request to add the new language is merged, but this denotes your dedication
upfront—for a pull request adding a new language to be merged, it needs at least
one review from a speaker of that language _and_ at least two localization team
members. No one is _required_ to join a localization team, even if they
introduced support for the language.
Every locale has a _localization team_ consisting of the locale's _maintainers_.
These maintainers are responsible for upkeep of their locale's translations.
Anyone can contribute strings for any language's translations, and may also
volunteer to join that locale's team; a locale maintainer is only distinguished
from other speakers of the language in that:

1. Locale maintainers _declare commitment_ to updating their translations.
2. Locale maintainers are _occasionally pinged_, via GitHub's @mentions, when
there are untranslated strings.
3. Locale maintainers are _informed of updates_ to the translations they
maintain via GitHub's review requests.

That's all there is to it, really. If you wish, you may leave your localization

@00-kat 00-kat May 17, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

“That's all there is to it, really.” is a pretty strong way of saying the above list is exhaustive; I don't think there's any other things about locale maintainers, but I might be wrong.

@00-kat 00-kat May 20, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like mentioning that a maintainer is allowed to only deal with updates, or only review, would be helpful, since currently the list is more precise than reality. I'm not sure how to word it though, since there's also the extra “there must be at least one reviewer and at least one updater” restriction.

teams at any point in the future.

Each localization team must have at least two maintainers, who can review each
Comment thread
trag1c marked this conversation as resolved.
other's translations. Likewise, if you open a pull request for a new language,
it won't be merged until at least two people volunteer. You—the creator of the
PR—likely intend to continue helping out with them, so please make it clear
up-front if that is not your intent.
Comment thread
trag1c marked this conversation as resolved.

There is no requirement that locale maintainers must not know each other. If you
are adding translations for languages that have few speakers, you might wish to
ask a friend of yours who also speaks that language whether they'd be willing to
help with Ghostty translations.

### `CODEOWNERS`

Expand Down
Loading