Proposal: CloudEvents Spec in Chinese #899
Conversation
|
It's on the agenda for the call today. |
Thanks a lot for replying. I'll re-base it asap. |
|
@JieDing the problem isn't the files, the problem is you have old (other people's) commits as part of this PR. You should rebase on top of the latest version of the branch ( |
Chinese-Manual/README.md
Outdated
| in Chinese for people who are new to CloudEvents. | ||
| Most of the content is translated from the original English version. | ||
| It is strongly recommended to read the English version if you find anything lost in translation. | ||
|
|
There was a problem hiding this comment.
This section describes why we need CloudEvents in Chinese. Suggest adding a section title (both English and Chinese) to this section.
Chinese-Manual/spec_CN.md
Outdated
| 所有实现都必须支持 [JSON 格式](json-format.md)。 | ||
|
|
||
| 有关规范背后的历史、开发和设计原理等更多信息， | ||
| 请参阅 CloudEvents [入门文档](primer_CN.md)。 |
There was a problem hiding this comment.
These links are broken when I clicked them. Not sure if the issue is specific to me.
JieDing
changed the title
Chinese-Manual/README.md
Outdated
| | | 最新版本 | 工作草稿 | | ||
| | :---------------------------- | :-----------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------: | | ||
| | **核心标准:** | | ||
| | CloudEvents | [v1.0.1](https://github.com/cloudevents/spec/blob/v1.0.1/spec.md) | [master](https://github.com/cloudevents/spec/blob/master/spec.md) | |
There was a problem hiding this comment.
I think the links here are old since the branch is now "main"
|
@JieDing thanks a ton for doing this. We discussed this on last week's call and there were just a few comments:
|
|
Signed-off-by: JieDing <dingjwilliams@gmail.com>
| 事件(Events)在现代系统中无处不在。但不同的事件生产者往往用不同的规范来描述自己的事件。 | ||
|
|
||
| 对事件的统一描述的匮乏意味着开发者必须不断重新学习如何消费不同定义的事件。它同样限制了那些用来帮助事件数据完成 | ||
| 跨环境传输的库(如SDKs)，工具(如事件路由器)和基础设施(如事件追踪系统)的发展。总体来看，这种匮乏严重阻碍了事件数据的可移植性和生产力。 |
There was a problem hiding this comment.
use chinese bracket; use '、' replace '，'.
|
|
||
| CloudEvents是一个以通用格式来描述事件数据的标准。它提供了事件在服务、平台和系统中的互操作性。 | ||
|
|
||
| CloudEvents 收获了从主流云厂商到SaaS公司的广泛关注。CloudEvents被[云原生计算基金会](https://cncf.io) (CNCF)持有， |
There was a problem hiding this comment.
no space, and I think below is better.
从主流云厂商到SaaS公司，工业界对CloudEvents兴趣浓烈。CloudEvents项目由云原生计算基金会托管，于2018年5月15日成为云原生沙箱级项目。
|
|
||
| 现有文件如下: | ||
|
|
||
| | | 最新版本 | 工作草稿 | |
| | Primer | [v1.0.1](https://github.com/cloudevents/spec/blob/v1.0.1/primer.md) | [WIP](https://github.com/cloudevents/spec/blob/main/cloudevents/primer.md) | | ||
| | Proprietary Specifications | - | [WIP](https://github.com/cloudevents/spec/blob/main/cloudevents/proprietary-specs.md) | | ||
|
|
||
| 对于初次接触CloudEvents的同学，可以通过阅读[入门文档](primer_CN.md)增加对CloudEvents规范的目标和设计理念 |
There was a problem hiding this comment.
推荐先行阅读入门文档了解CloudEvents规范的目标和设计理念，再阅读核心规范
| | Proprietary Specifications | - | [WIP](https://github.com/cloudevents/spec/blob/main/cloudevents/proprietary-specs.md) | | ||
|
|
||
| 对于初次接触CloudEvents的同学，可以通过阅读[入门文档](primer_CN.md)增加对CloudEvents规范的目标和设计理念 | ||
| 的总体理解， |
| 的总体理解， | ||
| 希望在最短时间内使用CloudEvents 规范的同学，可以直接阅读[核心规范](spec_CN.md)。 | ||
|
|
||
| 由于并非所有事件生产者都默认生产符合CloudEvents规范的事件，因此可以用[CloudEvents适配器](https://github.com/cloudevents/spec/blob/main/cloudevents/adapters.md) |
There was a problem hiding this comment.
现实环境中，很多事件生产者没有生成符合CloudEvents规范的事件，因此我们给出了将主流事件格式转换为CloudEvents格式的适配方法，详情请参考CloudEvents适配器
There was a problem hiding this comment.
I kind of like the original version better.
|
@JieDing did you want to address the comments made? |
fix typo add translation Signed-off-by: JieDing <dingjwilliams@gmail.com>
|
@JieDing thanks! I'll add it to this week's agenda for final approaval |
I do feel happy to make a contribution to CloudEvents. Just let me know if anything needs to be modified. |
|
Approved on the 12/02 call |
Proposed Changes
I'd like to translate a Chinese Version Specification based on the English one in order to lower the difficulty of reading and accelerate the spread of CloudEvents for Chinese developers.
-Currently, these documents below have been done based on the spec v1.0.1 and v1.0:
-README.md, primer.md and spec.md.
-other documents in both versions can be started later if necessary.
@duglin