readthedocs.org icon indicating copy to clipboard operation
readthedocs.org copied to clipboard

Help translate Read the Docs

Open agjohnson opened this issue 7 years ago • 11 comments

Read the Docs has a number of language translations that are either not fully translated or need translation reviewers to approve the translations in order for us to use them.

This is a great place to contribute if you want to contribute to Read the Docs but aren't familiar with our code or even programming in general.

We use Transifex for managing our translation workflow. If you have a user account on Transifex, you can help contribute translations or can become a translation reviewer to help approve translator contributions.

Our current translation state can be found here (note this does not include the amount of translations that have been approved, but currently this is 0% for most languages). https://www.transifex.com/readthedocs/readthedocs/

The languages that have translations but aren't currently reviewed are closest to being usable, but we can still use help translating languages that aren't translated or have little/no translators.

We also will be focusing on translating our documentation project soon: https://www.transifex.com/readthedocs/readthedocs-docs/languages/

There are less complete translation here however.

To get started, feel free to contribute translations or message myself or another language coordinator to help with translation reviews.

agjohnson avatar Aug 03 '18 02:08 agjohnson

Should this be on the ReadTheDocs docs itself, so that we don't have a constant open issue?

RichardLitt avatar Sep 10 '18 01:09 RichardLitt

i want to contribute..... on it.

veer11997 avatar Feb 27 '19 07:02 veer11997

Hello, I want to contribute with spanish, thanks

yesidays avatar May 31 '21 15:05 yesidays

@agjohnson What is the current status of these translations? Do we still accept external contributors? I'm happy to document the process a bit more in our official docs, as @RichardLitt suggested.

astrojuanlu avatar Jun 02 '21 11:06 astrojuanlu

This issue is still valid, though it's less of an issue and more of a pointer for folks to go to transifex. We used to get submissions of MO/PO files directly and would have to close them.

We need more eyes on transifex and our translation process in generally. I think I might be the only one who has done any work with our documentation or application translations at Transifex recently (it's not that recently actually), and it looks no one has run our application translation update commands for a couple years :disappointed:

agjohnson avatar Jun 10 '21 22:06 agjohnson

Also, very unfortunately, Transifex is a completely different workflow, it's a completely different community to manage, and is difficult to work back into our release workflow. I'd like to see our translations updated at release if possible, but we haven't picked up a cadence there.

agjohnson avatar Jun 10 '21 23:06 agjohnson

Hi I wanted to see if translations were still being reviewed on the transifex website

RaulGalvez288 avatar Aug 20 '24 03:08 RaulGalvez288

Hello, I want to contribute with spanish translations :D

reby22 avatar Oct 21 '24 23:10 reby22

Hi, I want to contribute with Mandarin translations since they are still not completed.

yuyiz67 avatar Mar 01 '25 00:03 yuyiz67

Hello, I want to contribute with spanish translations

JPMendiet4 avatar May 12 '25 18:05 JPMendiet4

Anyone willing to contribute:

  1. Browse https://explore.transifex.com/readthedocs/readthedocs/
  2. Join readthedocs's UI translation by pressing "join this project" button in the right-side if the page.
  3. Create a Transifex account if you don't have one.
  4. Join the desired language if it exists, request new language if you don't find the desired language in the list of currently being translated.

rffontenelle avatar May 12 '25 19:05 rffontenelle

Hi! I am Priyanshi, This is my first time starting the HacktoberFest. I wish to contribute in Gujarati. I feel this is can be a great starting point for me to begin my open source contribution journey and I can confidently do it ASAP if you assign me this.

pric-logic avatar Oct 11 '25 09:10 pric-logic

@pric-logic Translations happen on Transifex, as pointed out in the first message. You may want to join there to contribute. But it doesn't result in pull requests, so if you are aiming to meeting Hacktoberfest goals, then you might want to make other code contributions to RTD.

rffontenelle avatar Oct 11 '25 12:10 rffontenelle