search

Parsl / parsl

Parsl - a Python parallel scripting library
http://parsl-project.org
Apache License 2.0
509 stars 195 forks source link

Quickstart Guide Translations #3233

Open sophie-bui opened 8 months ago

sophie-bui commented 8 months ago

Task Overview

We need your help translating our Quickstart guide from English to other top languages spoken around the world. This task is written with first-time contributors and Outreachy applicants in mind and includes detailed instructions on how to complete this task. Adding translations will help expand our open-source community and increase the adoption of Parsl worldwide.

For this task, we will use Google Docs and Google Drive – free collaborative tools available to Gmail accounts. This is a collaborative writing task where contributors work together to ensure the translation is accurate and up-to-date.

How to Complete this Task

  1. Sign into your Google account

  2. Go to our Quickstart Translations folder. Check and see if there is already an existing document in the language you are planning to contribute to.

    • If there is NOT an existing document, proceed with the next step.
    • If there IS an existing document in that language, double-click it to access the doc. Go to step 7 in these instructions.

  3. Locate the “Quickstart Guide Template” doc in the folder

  4. You will see three vertical docs on the far right side of the doc – click on it to expand a dropdown menu. Select “Make a copy” – this will create a copy of the template within this folder. View this screenshot for reference. You will only be able to make a copy if you are signed into a Google account.

  5. Double-click on your copy doc titled “Copy of Quickstart Guide Template” to open the document in a separate window/tab.

  6. While in the Google Doc, rename the document by clicking on the name in the top left corner of the Google Doc using this naming convention: Language_Quickstart Guide-xx (xx is placeholder text for the two-letter language code, which can be found here: https://www.w3schools.com/tags/ref_language_codes.asp). For example, for the Vietnamese translation, the doc should be renamed Vietnamese_Quickstart Guide-vi.

  7. Go to the “Contributors” section toward the end of the document. You will find a table where you can add your details. If all the rows are full, go to the last row and right-click it to “insert row below” – a new row will appear.

  8. Return to this GitHub task. Add a comment that you are working on translating the Language_Quickstart Guide-xx (insert correct document name), share what you are doing (i.e. writing, reviewing, and post the link to the Google Doc you’re working on.

  9. Now, you can help translate the document. Do not translate the code snippets (in yellow-green boxes); only translate the instructions and information text.

  10. Go back to the “Contributors” section within the Google Doc and add a brief description of what you did to contribute.

🤔 Questions?

Mention @sophie-bui in a comment in this thread or reach out to her on Parsl's Slack.

christailu commented 8 months ago

Hello @sophie-bui , can I be assigned this task for the French Language? I am a native french speaker. I think I can manage to do the french Translation.

MundiaNderi commented 8 months ago

@sophie-bui there are 5 languages in the link you shared, but Deutsch is not in that list. I have B1 Deustch knowledge. Is the list restricted to the 5 languages ?

christailu commented 8 months ago

@sophie-bui , I am working on the French Translation already, Since there was not one I am writing it(Translate from the English guide). here is the link: https://docs.google.com/document/d/1AZ2eeotQqZ-2Oz_nM-YRpdoOFhjxtfpfDbbwNCZR5IQ/edit#heading=h.aa4rmczcl6m5

JO-YE commented 8 months ago

@sophie-bui, I'm thrilled to take on the translation to Spanish. Here's the link to the document: https://docs.google.com/document/d/1BCqINEQfJgOB2HybZa-hDfRBHv7eqI3CG-x6XbYCp5I/edit?usp=sharing

nawarajshah commented 8 months ago

@sophie-bui, I have translated the written document from English to German (German_Quickstart Guide-de). Here is the link to the document: https://docs.google.com/document/d/1JoTBpdw2XIPYp0nUmmTawYQDB3QwjCHrDG4PspidQBI/edit?usp=sharing

jessielin34 commented 8 months ago

@sophie-bui I'm going to be translating the Quickstart guide into Chinese. Here is the name of the document: Chinese(Simplified)_Quickstart Guide-zh-Hans. Link: https://docs.google.com/document/d/1WdH4W-MjxqFpURzoYpPiJtZu0Pb3xpk9xejglqZVqjk/edit?usp=sharing

Perpy-del commented 8 months ago

@sophie-bui I'm going to be translating the Quickstart guide into Arabic. Here is the name of the document: Arabic_Quickstart Guide-ar. Link: https://docs.google.com/document/d/1dR7Bo0XVw_izxlqfLWJXFcFcotHJGXCHC-sMj1EVJqI/edit?usp=sharing

sophie-bui commented 8 months ago

Thank you, everyone, for your excitement about contributing to this guide! I want to note a couple of things: contributors should select a language they are comfortable with. Please do not run excerpts through a translator app or program in a language you are unfamiliar with and cannot maintain. There isn't a great way for me to verify whether a translation is accurate, so I need the community to collaborate and check each other's work. Remember to follow the instructions I outlined above and log your contribution at the end of the document.

I will be reviewing items over the next couple of weeks.

sophie-bui commented 8 months ago

@sophie-bui there are 5 languages in the link you shared, but Deutsch is not in that list. I have B1 Deustch knowledge. Is the list restricted to the 5 languages ?

@MundiaNderi, the only restriction we have is translating it to one of the top languages spoken around the world – please refer to the link provided above. The Quickstart Translation Google Drive folder is the development/collaborative workspace for contributors who are familiar with the selected language to translate the guide together. Please make sure you are reading the instructions above carefully as it details the entire process. With your interest in translating it to Deutsch/German, there is already an existing German translation doc created by @nawarajshah and you can contribute to it here: https://docs.google.com/document/d/1JoTBpdw2XIPYp0nUmmTawYQDB3QwjCHrDG4PspidQBI/edit#heading=h.aa4rmczcl6m5. I hope that helps!

jessielin34 commented 8 months ago

@sophie-bui I've completed the English to Chinese (simplified) translations in the google folder!

Olotuah commented 8 months ago

@sophie-bui I am currently working on translating the Yoruba_Quickstart Guide-yo document. I've made a copy of the document, renamed it following the naming convention with the Yoruba language code, and added my details to the Contributors section. You can track my progress and provide feedback on the translation by accessing the document through this link: https://docs.google.com/document/d/1retPq9U2oST57AEd54te912TWVcNYbhbk6J4ZElAXlA/edit?usp=sharing

Perpy-del commented 8 months ago

@sophie-bui I am currently working on translating the Igbo_Quickstart_Guide_ig document. Here is the link to the translation: https://docs.google.com/document/d/1N4e-xzQE2lbVHk3kHwWyEHjw4yxMFcz74d-TM1Jz9nY/edit?usp=sharing

Dikshya09 commented 8 months ago

@sophie-bui I'm going to be translating the QuickStart guide into Hindi (Indian Language). Here is the link https://docs.google.com/document/d/12ORskG3FOrOM-QItjcMLfY5gYd1yc125_pazSAWGSW4/edit Screenshot 2024-03-29 105623 of the document:

Insharamin12 commented 8 months ago

Hey @sophie-bui

I've made changes to the document named Indian_Quickstart Guide-hi Here's the link to the doc: https://docs.google.com/document/d/11pe7fzSPts4URS339ZflwsKTU7-YOfy0f4uETXdRQIM/edit?usp=sharing

sidrakhandev commented 8 months ago

Hello @sophie-bui Document:

What I'm doing:

Below is the link to the Doc: