Update `translation/translators.rst` by StanFromIreland · Pull Request #1576 · python/devguide · GitHub

This is a very rough draft that has been opened for the purpose of asking some questions and is subject to a lot of change, some of which I have already done locally.

There are some small changes to coordinating.rst in this pull request which came up as I was working on this.

cc @willingc

📚 Documentation preview 📚: https://cpython-devguide--1576.org.readthedocs.build/documentation/translations

cc @JulienPalard Is this correct, it is what I gathered from the repositories though it is in French so I may be wrong?

This is correct. French translation happens at AFPy's Gitea and are simply mirrored to GitHub.

Instead of "GitHub" or "AFPy", there could be "repo" or "repository" text which links to the proper translation repository (for all rows in the table). Please add a comma before "Mirror"

This is correct. French translation happens at AFPy's Gitea and are simply mirrored to GitHub.

Instead of "GitHub" or "AFPy", there could be "repo" or "repository" text which links to the proper translation repository (for all rows in the table). Please add a comma before "Mirror"

Hi @StanFromIreland, I rereviewed. Thanks for putting together. I have only one small grammar nit and a question about max depth. Neither are blockers so I'm going to approve this PR. After I hear back from you or others, I am happy to merge.

Co-authored-by: Carol Willing <carolcode@willingconsulting.com>

Thank you for your work on it! I've left some comments.

Thanks for addressing my comments, answering some of the replies.

I suggest that we incorporate some of @hugovk's suggestions. Thanks @StanFromIreland.

@hugovk I'm leaving this in your capable hands to merge when your suggestions are incorporated. @StanFromIreland Thanks for working together with folks on the review. I'm loving how these docs are coming together.

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

Suggestions were added and #1585 added to address the build scripts suggestion.

Thanks @StanFromIreland and to everyone who reviewed this PR. Working together we now have much clearer info for coordinators and translators. 🚀 Keep up the collaboration. ☀️

Many thanks to everyone who reviewed!

Thanks @StanFromIreland and everyone that contributed for improving translation docs!

@StanFromIreland Please could you check the new warnings?

contrib/doc/translating.rst:12: WARNING: undefined label: 'translating' [ref.ref]
contrib/index.rst:78: WARNING: unknown document: 'documentation/translations' [ref.doc]
index.rst:179: WARNING: undefined label: 'translating' [ref.ref]

@hugovk They are addressed in #1587 I can move them to a separate pr if you want?

It can wait, thanks!

Initial

9ca670a

StanFromIreland commented Jun 16, 2025

View reviewed changes

rffontenelle suggested changes Jun 16, 2025

View reviewed changes

Rafael's feedback

8960469

m-aciek requested changes Jun 16, 2025

View reviewed changes

Comment thread documentation/translations/coordinating.rst Outdated