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

Chinese translation for opentelemetry specs,docs etc #154

Open
sunface opened this issue Aug 1, 2019 · 10 comments

Comments

@sunface
Copy link

commented Aug 1, 2019

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

This comment has been minimized.

Copy link
Contributor

commented Aug 1, 2019

@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

This comment has been minimized.

Copy link
Contributor

commented Aug 1, 2019

@sunface

This comment has been minimized.

Copy link
Author

commented Aug 2, 2019

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

This comment has been minimized.

Copy link
Contributor

commented Aug 2, 2019

@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

This comment has been minimized.

Copy link
Contributor

commented Aug 2, 2019

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

This comment has been minimized.

Copy link
Author

commented Aug 3, 2019

@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

This comment has been minimized.

Copy link
Contributor

commented Aug 9, 2019

@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

This comment has been minimized.

Copy link
Author

commented Aug 10, 2019

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

This comment has been minimized.

Copy link
Contributor

commented Aug 10, 2019

@sunface

This comment has been minimized.

Copy link
Author

commented Aug 10, 2019

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
4 participants
You can’t perform that action at this time.