Community: Chinese translation for opentelemetry specs,docs etc

[sunface]

Hi all:
Great work on OpenTelemetry!

We are a translation team from china, and we sincerely want to translate OpenTelemetry's specs,docs to chinese to make more people knowing and using opentelemetry in the future.

Our work has already begun: @opentelemetry-cn(cn is short for china), so if you have any questions or suggestions, please notify us, and we will do better late

[bhs]

@sunface first of all, thank you, this is much appreciated.

I'm wondering if it would make more sense to create the various repos within the main OpenTelemetry GitHub organization... that is, to create open-telemetry/specification-cn, open-telemetry/community-cn, etc. This would be more discoverable, and also play nicer with the GitHub permissions model.

Also, which repos are we talking about replicating? Just the document-heavy repos, or the others as well? (I would be nervous about keeping the code-focused programming-language repos in sync across human-languages so would prefer not to fork those for this purpose, but rather to find ways to keep docs translated within those repos... though I'm open to other opinions and lessons from other projects)

What do you think?

[mtwo]

+1 to Ben's suggestion

---

From: Ben Sigelman [e-mail]
Sent: Thursday, August 1, 2019 12:42 PM
To: open-telemetry/community [e-mail]
Cc: Subscribed [e-mail]
Subject: Re: [open-telemetry/community] Chinese translation for opentelemetry specs,docs etc (#154)

@sunfacehttps://eur02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fsunface&data=02%7C01%7C%7C9fcb3c328ac34ff5e1c508d716b86188%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C637002853473009929&sdata=KdpczDtUp0udcNOVEJyHc%2FRLCCYQ8IOatCckwyZI0Xg%3D&reserved=0 first of all, thank you, this is much appreciated.

I'm wondering if it would make more sense to create the various repos within the main OpenTelemetry GitHub organization... that is, to create open-telemetry/specification-cn, open-telemetry/community-cn, etc. This would be more discoverable, and also play nicer with the GitHub permissions model.

Also, which repos are we talking about replicating? Just the document-heavy repos, or the others as well? (I would be nervous about keeping the code-focused language repos in sync across languages so would prefer not to fork those for this purpose, but rather to find ways to keep docs translated within those repos... though I'm open to other opinions and lessons from other projects)

What do you think?

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHubhttps://eur02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fopen-telemetry%2Fcommunity%2Fissues%2F154%3Femail_source%3Dnotifications%26email_token%3DAAIXLK6EQYLHE7U2G5JF3UDQCM4CDA5CNFSM4IIOXFHKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD3LVRUQ%23issuecomment-517429458&data=02%7C01%7C%7C9fcb3c328ac34ff5e1c508d716b86188%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C637002853473019940&sdata=O6LZuFm%2Fdb6Z8%2B6wwT1tzDTPkOT2RONf9kgecaqHGD0%3D&reserved=0, or mute the threadhttps://eur02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FAAIXLK6NAX7NJOW24NVQYF3QCM4CDANCNFSM4IIOXFHA&data=02%7C01%7C%7C9fcb3c328ac34ff5e1c508d716b86188%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C637002853473029945&sdata=jct265QO1GP4kCD093NUAm2F9FdiHkzqbamFJzqEPoc%3D&reserved=0.

[sunface]

Hi @bhs @mtwo, thanks for your suggestions.

1. Great, we want to move our repo to main OpenTelemetry organization too,so which steps should we take to achieve that goal?
2. We will not do any code sync things, as the codes will be quickly changed in a long time, so it makes no sense.

Our main goals

• Translate the docs, specs,official blogs... to chinese
• Write chinese articles about OpenTelemetry(Technical principle, Core code analysis etc), by the way, we are also a experienced team good at APM)
• Maintain the chinese community such as online chatting with QQ, community Meetings in first-tier cities in china
• Help chinese developers to use OpenTelemetry in their projects

[mtwo]

@SergeyKanzhelev @yurishkuro @sarahnovotny @bogdandrutu FYI

@sunface I agree we shouldn't try to translate the code comments or perform any kind of code synchronization.

I suggest that we provide translations of the specs, community, and docs repos (and whichever others make sense). We can do this either in -cn versions of the existing repositories (as Ben suggested), or via -cn files and folders within each repository.

[yurishkuro]

My only concern is with whether this is going to be a one time translation effort or ongoing support, at least through the next 6 months when the specs will still be undergoing frequent changes.

I also prefer a separate -cn repo, unless we have two or more committers fluent in Chinese.

[sunface]

@yurishkuro
First of all, thanks for your question, it's really very important.

My answer is : this is going to be a long-term(years) ongoing support and chinese community maintaining, even if one day in the future we don't have time anymore, we will also recommand other chinese committers to do this.

• We are a team work on commercial APM for years. At first we are going to make our apm and pinpoint agent compatible with OpenTracing, now our plan surely turns to OpenTelemetry.

• We have three core members, and also maintained a golang commnunity(about 2000 acitve chinese members now) for 4 years, so a onetime translation will never happen.

BTW, our apm and opentracing experiences will help us to do translation and community maintaing better

[bhs]

@sunface thanks! So, can I create the following and make you an admin?

• github.com/open-telemetry/community-cn
• github.com/open-telemetry/specification-cn

I think translating the RFCs is too likely to fall out of date, but that would be the other obvious candidate for translation.

How do we track the status of the translation? Is there some way to mark the most-recent (English) commit that's been translated?

[sunface]

Hi, @bhs

You can create this one now: github.com/open-telemetry/docs-cn, and we will put specification, rfcs, sdk docs altogether in that repo.Otherwise, it's easy to manage.

There is a version tag in github.com/open-telemetry/specification, so we can use it in cn-repo to to keep both versions consistent.

[yurishkuro]

@sunface done https://github.com/open-telemetry/docs-cn

[sunface]

@yurishkuro thanks, can you invite @congim and @addname to this project? they are also in my team

[SergeyKanzhelev]

I have invited @congim and @addname bypassing the official request issue creation. Welcome!

Do you all need maintainer role on the repository?

[SergeyKanzhelev]

It looks like all permissions were set. Please accept invites. Re-open the issue or file a new one if you need more assistance, please