pulsar-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From GitBox <...@apache.org>
Subject [GitHub] [pulsar-translation] Anonymitaet commented on a change in pull request #6: Add workflow-guidelines
Date Sun, 25 Aug 2019 10:02:26 GMT
Anonymitaet commented on a change in pull request #6: Add workflow-guidelines
URL: https://github.com/apache/pulsar-translation/pull/6#discussion_r317390873
 
 

 ##########
 File path: workflow_guidelines.md
 ##########
 @@ -0,0 +1,177 @@
+# Translation workflow and guidelines
+
+Welcome to join the Pulsar translation project! Before translating, read translation [workflow](#workflow)
and [guidelines](#guidelines).
+
+## Workflow
+
+You can find [Apache Pulsar translation project](https://crowdin.com/project/apache-pulsar)
on Crowdin. For further details about the functions of Crowdin, see [Crowdin](https://crowdin.com/).
+Here are the steps of the translation workflow:
+
+### Join the Pulsar translation project
+1. Sign in [Apache Pulsar Crowdin project](https://crowdin.com/project/apache-pulsar). If
you don’t have a Crowdin account, on the crowdin page, click **SIGN UP** at the upper right
corner and fill in the information to create an account. If you have a GitHub, Facebook, Google,
Twitter or Gitlab account, you can link any of them to sign in.
+
+
+2. After signing in, click **Join** at the upper right corner on the crowdin page.
+> #### Note  
+> The source language of Pulsar files is English. The target languages of our translation
projects are Chinese, French and Japanese.  
+> Select a language. Take the **Simplified Chinese Translation Project** as an example.
+
+
+### Choose a file to translate and submit a PR
+1. Click **Simplified Chinese Translation Project**. 
+2. Click  **master > docs**,  and check out the status of each file. 
+Files in **master > docs** are the source files of the latest versions on Pulsar official
website. You only need to translate these markdown files.
+
+   
+- Green: translated and approved  
+- Blue: translated but not approved 
+- Grey: not translated
+
+![](media/translation-status.jpg)
+
+Based on your knowledge about Pulsar, you can translate the content that you are familiar
with first.
+
+After choosing the file to translate, please check it out in [Translation schedule](https://github.com/apache/pulsar-translation/blob/master/schedule.md).
If you find someone is translating this file, please choose another one. If not, you can create
a PR and add the file  name to [Translation schedule](https://github.com/apache/pulsar-translation/blob/master/schedule.md).
Then you can submit the PR.
+
+### Label Setting
+- Reviewers : No need to set up. Reviewers will receive the notification of PR you submitted
automatically and will designate someone to handle it.
+- Assignees : Choose yourself to receive notifications.
+- Label : Choose “translation”.
+
+### Translating
+While translating, you don’t need to translate the ID of the file and keep the tag the
same as the source file.
+> ####mportant  
+> Don’t modify, omit or add a space in a tag, as the omission or relocation of a tag
leads to mistakes shown on the website.
+
+![](media/id-tag.jpg)
+
+You can modify and save the content directly. Your version will appear automatically at the
top of the translation list, as Crowdin will record different versions from different translators.
**TM AND MT TRANSLATION** in the bottom-right corner offers you TMs in Pulsar, Crowdin, and
other websites.
+
+![](media/translation-interface.jpg)
+
+> #### Tip
+> You can use and update [Pulsar 文档翻译术语库](https://shimo.im/sheets/5jozGy5WIUQQf5JV/MODOC)
while translating.
+
+### Review
+After finishing a translation, please leave a comment in your PR.  : 
+For example, I've finished the translation, could you help review?
+
+After receiving the comment, reviewers start to review. The reviewer can make simple comments
and notify the translator. Direct discussion in PR is encouraged.
+
+If there are no problems, the reviewer will approve this PR and merge it.
+
+The following image gives a general workflow. The workflow source file is available  at [lucidchat](https://www.lucidchart.com/invitations/accept/0ebad9d8-ddf3-4a92-8ee6-e813a9bc58ff).
  
 
 Review comment:
   ```suggestion
   The following image gives a general workflow. The workflow source file is available at
[lucidchat](https://www.lucidchart.com/invitations/accept/0ebad9d8-ddf3-4a92-8ee6-e813a9bc58ff).
  
   ```

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

Mime
View raw message