Provide a translation dashboard

[AA-Turner]

The most recent documentation monthly meeting discussed providing a dashboard for the translations and progress.

Suggestions:

• Link to Maciej's dashoard from the devguide
  • https://m-aciek.github.io/pydocs-translation-dashboard/
  • https://github.com/m-aciek/pydocs-translation-dashboard/
  • cc @m-aciek
• Add translation contribution links to the dashboard
• Perhaps move the dashboard to docs.python.org/translations
  • This could be achieved by plugging in to docsbuild-scripts

Relevant prior art: https://translations.react.dev/

A

[m-aciek]

I'm happy to move the repo to Python org on GitHub or to integrate it into docs-build scripts repo. I was about to add a permissive license info (MIT?) to the project, will try to do it soon.

contribution links

What do you mean by that? Linking to devguide/translating from dashboard? Or some other per-language-project links?

[AA-Turner]

I'm happy to move the repo to Python org on GitHub or to integrate it into docs-build scripts repo. I was about to add a permissive license info (MIT?) to the project, will try to do it soon.

Wonderful! Make sure that all others with copyrightable contributions consent.

MIT seems fine, other options could include CC-1.0 (used by PEPs code) or 0BSD (used in pythoncapi-compat), but these are more permissive.

My preference would be to include it in docsbuild-scripts, but others may have a different view -- let's wait for other comments.

What do you mean by that?

Sorry for being unclear, I meant links to contribute to each translation, like on the React dashboard.

A

[adorilson]

• Add translation contribution links to the dashboard

This is already provided by the language column in Maciej's dashboard. Or not?

• Perhaps move the dashboard to docs.python.org/translations

What about updating https://devguide.python.org/documentation/translating/ with dashboard data instead of creating a new page?

[AA-Turner]

The language column links to the repo, which often isn't where to directly translate text. I envisaged linking to both the repo and eg transifex.

I suggest having a dedicated page to allow updating more frequently and to allow it to be single purpose. We could put this in the devguide but it feels like a bit of a stretch to include dashboard-like content.

A

[adorilson]

The language column links to the repo, which often isn't where to directly translate text. I envisaged linking to both the repo and eg transifex.

So, do you mean the Link column at https://devguide.python.org/documentation/translating/#translating ?

I suggest having a dedicated page to allow updating more frequently and to allow it to be single purpose. We could put this in the devguide but it feels like a bit of a stretch to include dashboard-like content.

My concern is about avoiding duplication and/or fragmentation. Maybe we can do the opposite: move the table on the page above to the dashboard (I mean not the table itself, but the content) and keep the paragraph and link to the dashboard. Something like:

[hugovk]

Wonderful! Make sure that all others with copyrightable contributions consent.

MIT seems fine, other options could include CC-1.0 (used by PEPs code) or 0BSD (used in pythoncapi-compat), but these are more permissive.

I've contributed. I consent to MIT, CC-1.0 and 0BSD, and open to considering others.