# PEP 545: Update PEP **URL:** \ **Category:** PEPs\ **Created:** [March 7, 2025, 8:25pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534 "2025-03-07T20:25:14Z")\ **Posts on this page:** 18\ **Page:** 1
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [March 7, 2025, 8:25pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/1 "2025-03-07T20:25:14Z")
Hello everyone, I would like to propose three modifications to PEP 545. Their implementations have been split in to separate PRs and should be reviewed separately (so that one rejected suggestion doesn’t block the rest): ## 1. [Add a section on maintaining translation quality](https://github.com/python/peps/pull/4296) > **Preview** > > > **Translation Quality** > > > > While maintaining translation quality is primarily up to the coordinator, > > the translation should aim for a similar level of quality as that of the English > > documentation. Machine translations that have not been reviewed by a human are > > not allowed. I believe this is important so that the standards of the Python docs do not degrade, especially with the current developments of AI which may seem temping to use. (It’s getting better at translating, but it’s still not great, it needs supervision) ## 2. [Add section on management of translations](https://github.com/python/peps/pull/4297) > **Preview** > > > ## Management of Translations > > > > Translations are overseen by the :pep:`Editorial Board <732#scope>`. > > but it is intended that each language team remains as autonomous as possible. > > > > **Inactive Coordinators** > > > > If a coordinator is inactive for a year and does not respond within a two weeks to a > > check-in issue on their translations issue tracker the coordinator will be marked > > as inactive. > > > > They will be moved to an “Inactive Coordinators” section on the devguide translations > > page and the translation will be free to claim by anyone willing to coordinate by > > opening a PR in the devguide repository adding themselves as coordinator. > > > > The translation may also be temporarily managed by a user willing to maintain it > > ideally with previous coordination experience. > > (propagating translations, managing CI workflows, accepting PRs, etc.) > > _Mar 7, 21:23: changed notification period from one week to two weeks_ This addition mainly focuses on what to do when a translation is abandoned and it will be helpful for future additions if other issues arise. The [devguide](https://devguide.python.org/documentation/translating/) lists several contributors who have been inactive for well over a year and some who have not made any start to the translation whatsoever! This means the translation is out of date, when it could easily be pushed to newer branches, people are unable to contribute, for who is going to merge prs!, new contributors won’t join if there is no promotion and other problems. For example: - The Bengali Translation, was claimed several years ago and not a commit in sight! It prevents [people](https://github.com/python/python-docs-bn-in/issues/2) who wish to become coordinator and translate from doing so. - Hungarian Translation, not updated for 7 years, branch well out of date. - Indonesian translation, a contributor is yet again [blocked](https://github.com/python/python-docs-id/issues/22). - Russian and others similar thing, you can see the [dashboard](https://python-docs-translations.github.io/dashboard/) for inactive translations ## 3. [Add section on improving methods of finding new translators](https://github.com/python/peps/pull/4298) > **Preview** > > > Improve Methods of Finding Translators > > > > Finding new translators is difficult. For this reason the devguide’s > > `*help-documenting* page `\_ > > will have a section on Translating. On [https://docs.python.org](https://docs.python.org) when on a translation > > (/lang) the footer will include the link: “Help Translating” that will link to > > the translations contributing guide. I work on the PL translation and it is difficult to get new translators, it is also not easy for people who would like to help to find out how to do so! There is no direct link to the translation repo in docs and the link that leads you to a page about contributing in the devguide also does not mention it! (And navigating the devguide is not the easiest) I also have [another pr](https://github.com/python/peps/pull/4295/files) with a few minor suggestions (update links http → https, and update b.p.o. → github issue tracker). I look forward to your suggestions 🙂 ---
**Author:** ![rffontenelle](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/rffontenelle/32/4568_2.png) [@rffontenelle](https://discuss.python.org/u/rffontenelle)\ **Post date:** [March 7, 2025, 8:59pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/2 "2025-03-07T20:59:21Z")
Hi Stan > [@Stanfromireland](#): > > If a coordinator is inactive for a year and does not respond within a week to a > check-in issue on their translations issue tracker the coordinator will be marked > as inactive. I suggest 2 weeks instead of 1. If it is inactive, one more week won’t make much difference. Also, how about marking the language team as “needing coordinator” and remove the name of the coordinator instead of marking the coordinator as inactive? Both mean the same thing, but I believe my suggestion has a more positive point of view. ---
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [March 7, 2025, 9:22pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/3 "2025-03-07T21:22:55Z")
> I suggest 2 weeks instead of 1. If it is inactive, one more week won’t make much difference. I agree, it is probably best to do 2 weeks just in case. > Also, how about marking the language team as “needing coordinator” and remove the name I see, I was hesitant to fully remove them. If there are no objections I can go with the _stronger_ version. ---
**Author:** ![hugovk](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/hugovk/32/14505_2.png) [@hugovk](https://discuss.python.org/u/hugovk)\ **Post date:** [March 17, 2025, 12:04pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/4 "2025-03-17T12:04:16Z")
Hi! Thank you for looking into this, and identifying areas where the translation process can be improved. I think this has been submitted to the SC ([python/steering-council#284](https://github.com/python/steering-council/issues/284)) a little early: this thread has only been open a week, with only one comment, and the draft PRs haven’t been updated with the suggestions – it’s not clear which versions you are asking the SC to decide upon. It would be good to hear from the PEP 545 authors: ping @julien, @methane and @vstinner. ---
**Author:** ![hugovk](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/hugovk/32/14505_2.png) [@hugovk](https://discuss.python.org/u/hugovk)\ **Post date:** [March 17, 2025, 12:04pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/5 "2025-03-17T12:04:25Z")
> [@Stanfromireland](#): > > ## 2. [Add section on management of translations](https://github.com/python/peps/pull/4297) > > … > > The [devguide](https://devguide.python.org/documentation/translating/) lists several contributors who have been inactive for well over a year and some who have not made any start to the translation whatsoever! This means the translation is out of date, when it could easily be pushed to newer branches, people are unable to contribute, for who is going to merge prs!, new contributors won’t join if there is no promotion and other problems. > > For example: > > - The Bengali Translation, was claimed several years ago and not a commit in sight! It prevents [people](https://github.com/python/python-docs-bn-in/issues/2) who wish to become coordinator and translate from doing so. > - Hungarian Translation, not updated for 7 years, branch well out of date. > - Indonesian translation, a contributor is yet again [blocked](https://github.com/python/python-docs-id/issues/22). > - Russian and others similar thing, you can see the [dashboard](https://python-docs-translations.github.io/dashboard/) for inactive translations I do think we need some process around inactive translations and how to assign a new co-ordinator, this is something not currently in the PEP. The Bengali and Indonesian issues have been open for less than two weeks. I think we have to mindful that most open source is done by volunteers, and real life happens. Plus translating is a lot of work, especially if done by a single person. Rather than removing people, can we find a way for people to work together? > [@rffontenelle](#): > > I suggest 2 weeks instead of 1. If it is inactive, one more week won’t make much difference. I agree one week is too short. > They will be moved to an “Inactive Coordinators” section on the devguide translations page and the translation will be free to claim by anyone willing to coordinate by opening a PR in the devguide repository adding themselves as coordinator. What’s the purpose of listing inactive coordinators? > The translation may also be temporarily managed by a user willing to maintain it > ideally with previous coordination experience. > (propagating translations, managing CI workflows, accepting PRs, etc.) What defines a temporary manager from a regular coordinator? Are there any time limits? ---
**Author:** ![hugovk](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/hugovk/32/14505_2.png) [@hugovk](https://discuss.python.org/u/hugovk)\ **Post date:** [March 17, 2025, 12:04pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/6 "2025-03-17T12:04:45Z")
> [@Stanfromireland](#): > > ## 3. [Add section on improving methods of finding new translators](https://github.com/python/peps/pull/4298) > > Preview > > > Improve Methods of Finding Translators > > > > Finding new translators is difficult. For this reason the devguide’s > > `*help-documenting* page `\_ > > will have a section on Translating. On [https://docs.python.org](https://docs.python.org) when on a translation > > (/lang) the footer will include the link: “Help Translating” that will link to > > the translations contributing guide. I’m not sure we need to update the PEP to prescribe making updates to the devguide and docs, I think we could address these directly through PRs/issues? ---
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [March 17, 2025, 12:36pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/7 "2025-03-17T12:36:39Z")
I submitted it after a week, as recommended on the SC issue tracker. I doubted I would get any more feedback after just one message in 7 days. I had updated the “previews” with suggestions in my SC issue. I can also update the PR already as I had decided to hold back on that till it is reviewed by the SC. ---
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [March 17, 2025, 12:40pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/8 "2025-03-17T12:40:56Z")
Your first point I will answer with two of your own quotes 🙂 > Rather than removing people, can we find a way for people to work together? > What’s the purpose of listing inactive coordinators? > real life happens Yes it does, so maybe with an easier process of replacement it may be less of a burden. If they are busy why should it block someone who is not? > I agree one week is too short. I updated it in my submission to the SC and in the preview here. > What defines a temporary manager from a regular coordinator? Are there any time limits? Its just somewho who wishes to help out but cannot be a real coordinator (e.g. they don’t speak the langauge) the time limit is till a proper coordinator is found or they get tired ---
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [March 17, 2025, 12:43pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/9 "2025-03-17T12:43:58Z")
> I’m not sure we need to update the PEP to prescribe making updates to the devguide and docs, I think we could address these directly through PRs/issues? Historically that has gone poorly… > > > !\[image\](https://github.com/user-attachments/assets/8b1dd84f-8c92-4d8e-82b0-01f9…78172d1b) > > > Discussion https://github.com/sphinx-doc/sphinx/issues/13301 > > > > \---- > 📚 Documentation preview 📚: https://cpython-previews--130355.org.readthedocs.build/ I thought that with SC approval it may be a bit easier. ---
**Author:** ![julien](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/julien/32/113_2.png) [@julien](https://discuss.python.org/u/julien)\ **Post date:** [March 20, 2025, 12:52pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/10 "2025-03-20T12:52:42Z")
I have the same two questions: > [@hugovk](#): > > What’s the purpose of listing inactive coordinators? > > What defines a temporary manager from a regular coordinator? Are there any time limits? Putting time limits on non-responding coordinators, listing unresponding coordinators in a specific list, naming temporary managers, it all needs work and add complexity. Who will do this work? Keep it simple. I designed PEP 545 to keep things simple: every translation team can manage their coordinators as they want. If they want to organize one shot election, yearly elections, name the first translator as a coordinator, or whatever: everything just works and we don’t need to add complexity to it. There’s no mention that the coordinator is the only one allowed to merge, so there should be no need for temporary managers: a translation can continue being updated with an inactive coordinator. And it’s up to each translation to decide when and how to choose another coordinator if the preceding one had left. So if something needs clarification maybe it is: translation teams are free to name new coordinators as needed. ---
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [March 20, 2025, 6:28pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/11 "2025-03-20T18:28:56Z")
You seem to have misunderstood my proposal, I could make it clearer? My proposal is for the extreme case. “but it is intended that each language team remains as autonomous as possible.” The board should only step in if there is **no** active coordinator. Like the case with the Bengali translation, it has nothing to do with if a coordinator goes inactive but there are others. This is the case when this: > If they want Is not possible, because the coordinator is inactive. And the following: > a translation can continue being updated with an inactive coordinator. is also not possible, for who is supposed to give merge permissions, the coordinator(s) are inactive!? > translation teams are free to name new coordinators as needed. This is not limited anywhere in my proposal. ---
**Author:** ![willingc](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/willingc/32/20_2.png) [@willingc](https://discuss.python.org/u/willingc)\ **Post date:** [April 10, 2025, 5:53pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/12 "2025-04-10T17:53:06Z")
The Steering Council has asked the Editorial Board to provide feedback. ---
**Author:** ![encukou](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/encukou/32/2461_2.png) [@encukou](https://discuss.python.org/u/encukou)\ **Post date:** [May 15, 2025, 9:28am UTC](https://discuss.python.org/t/pep-545-update-pep/83534/13 "2025-05-15T09:28:39Z")
The process decision is taking very long. In the mean time, would the EB be okay with blessing new coordinators in the specific cases where contributors are blocked? Looks like half a dozen or so of those have piled up over the years. (After all, it’s easier to codify a specific process _after_ it becomes boring.) ---
**Author:** ![hugovk](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/hugovk/32/14505_2.png) [@hugovk](https://discuss.python.org/u/hugovk)\ **Post date:** [May 15, 2025, 9:47am UTC](https://discuss.python.org/t/pep-545-update-pep/83534/14 "2025-05-15T09:47:59Z")
@encukou Please could you list the cases that need action? Those that I’m aware of: > - The Bengali Translation, was claimed several years ago and not a commit in sight! It prevents [people](https://github.com/python/python-docs-bn-in/issues/2) who wish to become coordinator and translate from doing so. This needs action. The new volunteers don’t have access to the repo and have begun work in a fork for now: [jojo96/python-docs-bn-in](https://github.com/jojo96/python-docs-bn-in). > - Indonesian translation, a contributor is yet again [blocked](https://github.com/python/python-docs-id/issues/22). This is progressing, see [python/editorial-board#29](https://github.com/python/editorial-board/issues/29): yesterday, EB has asked the new coordinator to open a devguide PR and will give them permissions. > - Hungarian Translation, not updated for 7 years, branch well out of date. What specific action needs taking here? Are there volunteers to continue the work? There’s nothing at [python/python-docs-hu](https://github.com/python/python-docs-hu), [python/editorial-board](https://github.com/python/editorial-board) or [python/docs-community](https://github.com/python/docs-community). > - Russian and others similar thing, you can see the [dashboard](https://python-docs-translations.github.io/dashboard/) for inactive translations Again, are there volunteers to continue the Russian translation? There are no issues at [GitHub - MLGRussianXP/python-docs-ru: Russian Translation of the Python Docs](https://github.com/MLGRussianXP/python-docs-ru) or the other repos. Same question for the other inactive translations. ---
**Author:** ![Stanfromireland](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/stanfromireland/32/10102_2.png) [@Stanfromireland](https://discuss.python.org/u/Stanfromireland)\ **Post date:** [May 15, 2025, 2:44pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/15 "2025-05-15T14:44:34Z")
> [@hugovk](#): > > What specific action needs taking here? The removal of the current coordinators to make it clear that new ones are required. This is where my idea of “temporary coordinators” came into play, we could merge the translations into newer branches and set up transfiex to allow less tech-informed users to contribute. There is also the Japanese translation, it has active contributors on transifex, but no active coordinator. ---
**Author:** ![encukou](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/encukou/32/2461_2.png) [@encukou](https://discuss.python.org/u/encukou)\ **Post date:** [May 16, 2025, 2:42pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/16 "2025-05-16T14:42:43Z")
> [@hugovk](#): > > This is progressing, see [python/editorial-board#29](https://github.com/python/editorial-board/issues/29): Ah, that’s what I missed! Thanks! So, there’s a way forward for people who want to coordinate – open a PR and ask the Editorial Board to review. That’s what I asked for; if I see anyone who feels blocked I can suggest this. Sorry for the noise! ---
**Author:** ![willingc](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/willingc/32/20_2.png) [@willingc](https://discuss.python.org/u/willingc)\ **Post date:** [May 17, 2025, 6:40pm UTC](https://discuss.python.org/t/pep-545-update-pep/83534/17 "2025-05-17T18:40:23Z")
I did post on Discord the next steps to unblock folks a few days ago. 😄 After PyCon, I will open an issue for discussion at the next docs community meeting. ---
**Author:** ![encukou](https://sea2.discourse-cdn.com/flex002/user_avatar/discuss.python.org/encukou/32/2461_2.png) [@encukou](https://discuss.python.org/u/encukou)\ **Post date:** [May 19, 2025, 7:23am UTC](https://discuss.python.org/t/pep-545-update-pep/83534/18 "2025-05-19T07:23:47Z")
Thank you! I missed them, and the Discord is now so big that I can’t find them any more ^^; To confirm, is “[open a PR against the devguide listing yourself as the coordinator](https://github.com/python/editorial-board/issues/29#issuecomment-2879712862), and ask the Editorial Board to review” a good summary? (I hope that ends up in a PEP, but probably better to do that after the discussion is over and the process has been tried a few times.)