Skip to content

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

Open
00-kat wants to merge 1 commit into
ghostty-org:mainfrom
00-kat:locale-team-docs
Open

Rewrite the localization teams docs to improve legibility, and explicitly permit members who know each other#12720
00-kat wants to merge 1 commit into
ghostty-org:mainfrom
00-kat:locale-team-docs

Conversation

@00-kat

@00-kat 00-kat commented May 17, 2026

Copy link
Copy Markdown
Contributor

Maybe I have too many exclamation marks, let me know if I should metaphorically calm down. Fixed now.

My wording is intentionally biased toward languages spoken less (edit: not nearly as much anymore), but I specifically do not disallow members who know each other regardless of language popularity. Quoting myself from Discord1:

people who know each other are more likely to have more similar tastes or quirks in their language use by virtue of (perhaps subconsciously) stealing off each other, and there's also the whole “eh it's good enough i trust that you thought it through” thing that's more likely if you know the other translators already

I don't believe it's necessarily worse, and if you have more than two members then the issue greatly diminishes too, but I don't want people to see this and go “oh no I need to get my translations in before Ghostty 1.4 that releases while I'm sleeping tomorrow so I should ask my bestie to help”, and to instead be willing to be more patient, at least for a reasonable amount of time (which I consider to be ≤ 2 months).

Footnotes

  1. @trag1c and I chatted about this prior to this PR in #maintainers on the Ghostty Discord server. If you have access to that channel, check out these links: 1, 2, 3.

@00-kat 00-kat requested a review from a team as a code owner May 17, 2026 15:45
@00-kat 00-kat added documentation Improvements or additions to documentation translations Translations of the Ghostty app labels May 17, 2026

@pluiedev pluiedev left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The exclamation marks were indeed a bit excessive but hey

Comment thread po/README_TRANSLATORS.md Outdated
Comment thread po/README_TRANSLATORS.md Outdated
Comment thread po/README_TRANSLATORS.md Outdated
@00-kat 00-kat force-pushed the locale-team-docs branch 2 times, most recently from 7e40ac2 to d2c7310 Compare May 17, 2026 17:09
@00-kat

00-kat commented May 17, 2026

Copy link
Copy Markdown
Contributor Author

Figured out a nice way to phrase the other parts of the old text that irked me.

@00-kat 00-kat force-pushed the locale-team-docs branch 2 times, most recently from 78b10c2 to 351799f Compare May 17, 2026 17:14
@00-kat 00-kat requested a review from pluiedev May 17, 2026 17:14
Comment thread po/README_TRANSLATORS.md
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

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.

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.

Comment thread po/README_TRANSLATORS.md Outdated
Comment thread po/README_TRANSLATORS.md
Comment thread po/README_TRANSLATORS.md
@00-kat 00-kat force-pushed the locale-team-docs branch from 351799f to e40a547 Compare May 20, 2026 05:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation translations Translations of the Ghostty app

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants