open-telemetry/docs-cn

OpenTelemetry 中文文档: 接入使用、技术标准、RFC、SDK等.

OpenTelemetry中文资料

目录索引

• OpenTelemetry简介
• 技术标准
• 社区支持
• 快速入门
• 案例指南

docs-cn's Issues

Add CODEOWNERS

提案：项目结构的定义

项目结构的定义

├── COMMUNITY-CN.md
├── CONTRIBUTING-CN.md
├── README.md
├── community
├── libs
│   └── java        
├── original             
│   ├── community         # https://github.com/open-telemetry/community
│   ├── specification     # https://github.com/open-telemetry/opentelemetry-specification
│   └── website           # Optional: https://github.com/open-telemetry/opentelemetry.io content/en
└── specification

original：

​ 使用 git submodule，作为原始英文文档，围绕其进行中文翻译。上游发布稳定版本后进行更新。

COMMUNITY-CN.md:

  用于记录和分析中文社区的文章与教程。

Add CONTRIBUTING.md

add some link to opentelemetry cn article

like https://yq.aliyun.com/articles/710154

新增`go`的`Instrumentation`翻译文件夹

新增文件夹 community/opentelemetryGoInstrumentation 存放go的Instrumentation的文档
原文地址：https://opentelemetry.io/docs/instrumentation/go/

• index.md #117
• getting-started.md #114
• libraries.md #116
• manual.md #115
• exporting_data.md #113

增加opentelemetry-java-instrumentation项目的开发引导文档翻译

增加opentelemetry collector文档的翻译

完善 specification/logs 文件夹内文章翻译

原文地址：https://opentelemetry.io/docs/reference/specification/logs/overview/
原文档仓库地址：https://github.com/open-telemetry/opentelemetry-specification/tree/main/specification/logs
翻译输出文件夹：https://github.com/open-telemetry/docs-cn/tree/main/specification/logs

• README.md
• data-model.md
• logging-library-sdk.md
• semantic_conventions

增加 library-guidelines.md 和 library-layout.md 的翻译

#58

the link for "参与中文文档贡献" is 404 not found.

in docs-cn/specification/Readme.md , the link https://gitter.im/open-telemetry/docs-cn for "参与中文文档贡献" is 404 not found in gitter. should we fix the link or disable the link ?

I enabled CLA check and requirement to do a PR

The CNCF policy is to enforce CLA on all repositories. Please let me know if it is a problem.

Chinese translation on opentelemetry.io website

Hello @open-telemetry/docs-cn-approvers, @open-telemetry/docs-cn-maintainers,

we just launched a landing page for a Chinese translation of opentelemetry.io, https://opentelemetry.io/zh/ and we would love to have more content added there and work with you to grow this effort. Please take a look at the following discussions and issues and let us know what you think!

open-telemetry/opentelemetry.io#4302
open-telemetry/community#2107
open-telemetry/opentelemetry.io#4465

cc @open-telemetry/docs-maintainers

增加 opentelemetry-js 的翻译

Request to participate in docs-cn maintenance

Hi all,

I am a developer from China, and very happy to be a member of opentelemetry open-telemetry/community#346. I have been continuously monitoring the progress of opentelemetry, and also participated in the contributions of opentelemetry-rust, opentelemetry-go, used opentelemetry-collector in the company's business.

With more and more attention to opentelemetry in China, It would be great if there is a Chinese document.Concerned about the docs-cn repo. Can I be set up as a maintainer? I am very willing to participate in maintenance, and look forward to attracting more Chinese community partners.

有windows系统日志收集的案例吗

有windows系统性能指标和系统日志收集的案例吗

关于中英文混排的讨论

我个人比较赞成这种方式

中文正文及标题中出现的英文及数字应该使用半角方式输入，并且在左右各留一个半角空格。如果这些这些半角英文及数字的左边或者右边紧接着任何的中文全角括号或者其他标点符号的话，则不需要加入半角空格。

Add labels to entry level tasks for new contributors

Hi,

based on open-telemetry/community#469 I have added open-telemetry/docs-cn to Up For Grabs:

https://up-for-grabs.net/#/filters?names=642

There are currently no issues with label help wanted. Please add this label to your entry level tasks, so people can find a way to contribute easily.

If "help wanted" is not the right label, let me know and I can change it (e.g. to "good first issue" or "up-for-grabs"), or you can provide a pull request by editing https://github.com/up-for-grabs/up-for-grabs.net/blob/gh-pages/_data/projects/opentelemetry-docs-cn.yml

Thanks!

是否需要统一特定单词的中文翻译

telemetry，有时候翻译成遥测，有时候翻译成遥感
trace，是用追踪还是链路，还是直接用英文原文
类似的应该还有很多，我觉得我们需要统一下规范，避免读者阅读时的困惑甚至翻译时的困惑。