⚠️ This repository is not a package.: The setup.py file is only in this repository as a requirement for building docs. If you'd like to install Qiskit, follow the link.

Qiskit Documentation Localization

First of all, thank you for showing interest in translating (localizing) Qiskit Documentation! This helps make the documentation more accessible and available to our global community.

If you are interested in contributing to translations, please follow the instructions below.

To sign up to participate in translations:

1. Open the LOCALIZATION_CONTRIBUTORS file. Look for the language header that you'd like to contribute to and sign up under there. If you do not find the language that you'd like to contribute to, please read this section.
   

2. Create a pull request (PR) to add your name to the list. Make sure to follow the template to open a Pull Request.
   

   • Each contributor has to create their own PR and sign the CLA (see #3 below).
   • If you have an open issue for a language request, add the issue link to the PR.

   (Not sure how to open a PR? Checkout this section)

3. If you have not contributed to Qiskit before, you will be prompted to sign the Qiskit Contributors License Agreement (CLA) in your PR.
   

4. In the Qiskit-Docs Crowdin project, choose the language that you want to contribute to.
   

5. Click the Join button and paste the URL of your PR in the dialog box where you are asked why you want to join the Crowdin project. Failing to do so will result in a delay in approving your request in Crowdin and your Pull Request in GitHub. The administrators of the Crowdin project will review your request and give you access as quickly as they can.
   

6. For questions regarding onboarding or strategy, to connect with other translators and receive updates regarding the project please join #qiskit-localization channel in the Qiskit workspace or make an issue in this repo.

What is Crowdin?

Qiskit documentation is translated (localized) using Crowdin, a software and web localization platform that allows organizations to coordinate translation projects and collaborate with communities to translate materials. Crowdin allows our community of translators to amplify their impact by automatically reusing the work invested in translating one sentence, to translate other, similar sentences. Crowdin also makes translations resilient to many types of changes to the original material, such as moving sentences around, even across files.

How to add a new language to translate?

The Qiskit Localization Project currently supports: Bengali, Chinese Simplified, Chinese Traditional, French, German, Greek, Hindi, Indonesian, Italian, Japanese, Korean, Malayalam, Marathi, Polish, Portuguese, Russian, Spanish, Swahili, Tamil, Thai, Turkish, and Vietnamese. These translations can be viewed from our staging site.

Japanese, German, Korean, Portuguese, French and Tamil documentation are now available in the Qiskit Documentation website.

The Machine Learning application tutorials are available in Bengali, French, Hindi, Italian, Japanese, Korean, Malayalam, Russian, Spanish, Tamil, Turkish, Vietnamese

As mentioned in the blog post Qiskit in my language is Qiskit, we want to make sure that translated languages have enough community support to ensure quality and consistency.

If you want to add a new language and become a translation lead, you can open a GitHub issue to start a discussion with the Qiskit team and recruit translation project members. Please refer to the criteria below to receive official support from the administrators for new languages.

What is the criteria for adding a new language?

1. A minimum of three contributors is necessary for any new languages to be added and receive official support from the administrators of the localization project.
   
2. In addition to translators, we will need dedicated proof-readers to review the translations and approve accuracy of content in that language, to ensure the translations can be released in that language.
   
3. Among the group of contributors, a translation lead must be identified to serve as a liaison with the administrators of the localization project. The lead must contact Soolu Thomas and Yuri Kobayashi by email for the language to be officially listed under this project.
   

These are general guidelines for joining translation efforts and adding new languages. If you have further questions, please feel free to contact Soolu Thomas and Yuri Kobayashi. Thank you.

How to add my name to LOCALIZATION_CONTRIBUTORS list and open a PR in GitHub?

Option 1: In Github (Recommended)

1. Click on the pen-like button which says "Edit this file" in the LOCALIZATION_CONTRIBUTORS file.
2. Add your name under the language you'd like to contribute to.
3. Once your name is added, scroll down and find a green button which says "Propose changes".
4. The page now reloads automatically and find and click on another green button - "Create pull request".
5. This should create the pull request and once that's done, follow the instructions (step 3, 4, 5).

Option 2: Creating a local clone of the repository and pushing from local

1. Clone this repository by following this guide.
2. Make sure your local git configuration by following the instructions here -- Setting username and Setting email
3. Create a branch by running git checkout -b BRANCH_NAME in your terminal.
4. Find LOCALIZATION_CONTRIBUTORS file in your local copy of qiskit-translations (created after cloning this repository) and add your name under the language you'd like to contribute to.
5. Now, in the terminal run git add LOCALIZATION_CONTRIBUTORS, git commit -m "Added name under LANGUAGE-NAME", git push origin BRANCH-NAME.
6. Follow the link in the terminal to open a pull request.

Digital Badges

At Qiskit, we feel that it is important to recognize the contributions that were made by its members to make our documentation more accessible to the global community. Starting in 2020, localization contributors who drove efforts in translating, proof-reading and managing progress can earn a Qiskit Localization Contributor Badge. For details, please refer to Qiskit Localization Digital Badges.

When you find an issue in the original documentation

During the process of translating Qiskit documentation, you may identify errors (mostly typos) in the original documentation. Please feel free to suggest corrections by opening an issue and choose Documentation.

Project Leads

Name	Slack (Qiskit Workspace)
Yuri Kobayashi	@Yuri Kobayashi
Samanvay Sharma	@sam
Soolu Thomas	@Soolu

Translation Leads (as of April 2022)

Language	Translation Leads	Slack (Qiskit Workspace)
Bengali	Abhijit Mitra, Sristy Sangskriti	@amitracal @Sristy Sangskriti
Chinese Simplified	Helena Zhang, Wen-Sen Lu	@Helena Zhang @Wen-Sen (Vince)
Chinese Traditional	Helena Zhang, Wen-Sen Lu	@Helena Zhang @Wen-Sen (Vince)
French	Jean-Michel Torres	@torresjm
German	Thorsten Muehge	@Thorsten Mühge
Greek	Vasilis Katopodis	@Vasilis Katopodis
Hindi	Samanvay Sharma, Guncha Malik	@sam @Guncha Malik
Indonesian	Rudy Raymond, Eraraya Ricardo Muten	@rraymondhp @Eraraya Ricardo Muten
Italian	Eleonora Picca, Federico Accetta	@Eleonora Picca @Federico Accetta
Japanese	Takehiko Amano	@Takehiko Amano
Korean	Soyoung Shin, Mingi Ryu	@Sophy @Mingi
Malayalam	Ansah Mohammad Kuriyodath	@Ansah
Marathi	Amol Deshmukh	@Amol Deshmukh
Polish	Piotr Biskupski	@pb.worker
Portuguese (United)	Luiz Henrique Galeoti de Lima, Omar Costa Hamido	@Luiz Galeoti @OCH
Russian	Vasily Shcherbinin, Farida Shagieva	@Vasily Shcherbinin @Farida
Spanish (United)	Claudia Zendejas-Morales, Rodrigo Rosado Rivial	@clausia @rodrigo rosado
Swahili	Karoki Mugambi	@Karoki Mugambi
Tamil	Manjula Gandhi	@Manjula Gandhi
Thai	Tanapat Deesuwan, Ruchipas Bavontaweepanya, Natchapol Patamawisut	@Tanapat @Ruchipas Bavontaweepanya @Bank Patamawisut
Turkish	Ayşin Sancı, Furkan Semih Dündar	@ayshine @Furkan Semih Dündar
Vietnamese	Rossy Nhung Nguyen	@Rossy Ng