Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Call for keeping on the Chinese doc maintenance #5250

Closed
rootsongjc opened this issue Oct 24, 2019 · 13 comments
Closed

Call for keeping on the Chinese doc maintenance #5250

rootsongjc opened this issue Oct 24, 2019 · 13 comments
Assignees
Labels
Milestone

Comments

@rootsongjc
Copy link
Member

@rootsongjc rootsongjc commented Oct 24, 2019

Dear @istio/wg-docs-maintainers , as you all know, since last year the ServiceMesher community was responsible for the translation of istio website. The community has submit 700+ PR merged.

However, the translation work has been stuck in version 1.2 for a long time. Recently, people often ask me where the Chinese documents are? I had to tell them it was archived here. Today I asked how many people in the community want to participate the Chinese doc translation activities. There will be dozens of people involved. Now we intend to restart translation and maintenance.

If you have no objection, we will make a plan and start the translation next week.

@malphi
Copy link
Contributor

@malphi malphi commented Oct 24, 2019

As the largest service mesh community in China, we've defined a detailed and effective plan to finish the translation mission with overconfidence.

@linsun
Copy link
Member

@linsun linsun commented Oct 24, 2019

That is great, when the translation is up to date - we will make it active on istio.io. pls keep us posted on the effort.

@geeknoid
Copy link
Contributor

@geeknoid geeknoid commented Oct 24, 2019

@rootsongjc rootsongjc self-assigned this Oct 25, 2019
@zhi-gang-sun
Copy link
Contributor

@zhi-gang-sun zhi-gang-sun commented Oct 25, 2019

Glad to see there are so many volunteers willing to contribute the translation, this will benefit the large service mesh community in China.

@yuxiaobo96
Copy link
Member

@yuxiaobo96 yuxiaobo96 commented Oct 25, 2019

That sounds like a good news.
I want to be a member of the translation istio documentation.
Should I join the ServiceMesher community first?

@rootsongjc
Copy link
Member Author

@rootsongjc rootsongjc commented Oct 25, 2019

@yuxiaobo96 yes, you should join ServiceMesher community first. Look here to find how to join the community.

@yuxiaobo96
Copy link
Member

@yuxiaobo96 yuxiaobo96 commented Oct 25, 2019

@rootsongjc Okay thank you.

@rootsongjc rootsongjc added the translation/chinese label Oct 25, 2019
@sbilly
Copy link

@sbilly sbilly commented Oct 26, 2019

support

@rootsongjc
Copy link
Member Author

@rootsongjc rootsongjc commented Oct 28, 2019

Here is the translation plan drafted by @malphi

Principles

  1. We will follow the master branch to translate and every PR can preview on https://preliminary.istio.io/zh/ page just like before. @geeknoid Is the page disabled now?
  2. Translate all of the contents for website, including document, blog, FAQ and about.
  3. Define glossary for the unification of translation.
  4. Translation task and process tracking here
  5. Use Scrum and this Github project as a tool to manage the process.
  6. A translation task includes translating and 2 round reviewing processes to ensure the quality of translation.
  7. When the Chinese and English versions are almost synchronized, we can release the Chinese version on https://zh.istio.io or https://istio.io/zh

@rootsongjc
Copy link
Member Author

@rootsongjc rootsongjc commented Oct 30, 2019

@geeknoid We plan to uncomment these in config.yaml to make Chinese docs show up.

#    [languages.zh]
#        contentDir = "content/zh"

And copy the English docs to content/zh, translate every single page one by one.

If you think this is OK, I will make a PR.

@istio-policy-bot istio-policy-bot added the lifecycle/needs-triage label Oct 30, 2019
rootsongjc added a commit to rootsongjc/istio.io that referenced this issue Oct 31, 2019
- Restart the Chinese translation precess, refer to istio#5250
- Translation progress is tracked on https://github.com/servicemesher/istio-official-translation
geeknoid pushed a commit that referenced this issue Nov 2, 2019
* zh-translation: initialize the translation content

- Restart the Chinese translation precess, refer to #5250
- Translation progress is tracked on https://github.com/servicemesher/istio-official-translation
@rcaballeromx
Copy link
Contributor

@rcaballeromx rcaballeromx commented Nov 4, 2019

@rootsongjc I'm very happy to see that the community is once again translating the content into ZH.
If there is anything I can do to help, please let me know.

@rootsongjc
Copy link
Member Author

@rootsongjc rootsongjc commented Nov 5, 2019

@rcaballeromx Thank you. For now, we need more maintainers for the Chinese docs. We need to know if the original maintainers still have time to maintain the Chinese content and we can replace it with others if possible. Because the workload of maintenance is also very large.

@istio-policy-bot istio-policy-bot removed the lifecycle/needs-triage label Nov 5, 2019
@geeknoid geeknoid added this to the 1.5 milestone Nov 29, 2019
@rootsongjc
Copy link
Member Author

@rootsongjc rootsongjc commented Dec 12, 2019

We already gathered 60 contributors since the translation activity restarted. So I'll close this issue if anyone wants to join us, you can find the way in https://github.com/servicemesher/istio-official-translation

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

9 participants