[zh] Sync demo/_index, development, and forking (#7207)

Signed-off-by: windsonsea <[email protected]>

Author: windsonsea

content/zh/docs/demo/_index.md

@@ -6,20 +6,19 @@ cascade:
 weight: 180
 default_lang_commit: c2cd5b14 # patched
 drifted_from_default: true
-cSpell:ignore: OLJCESPC
 ---
 
 欢迎使用 [OpenTelemetry 演示](/ecosystem/demo/)文档，
 此文档介绍了如何安装和运行演示，以及一些可用来查看 OpenTelemetry 实际运行情况的场景。
 
-## 运行演示
+## 运行演示 {#running-the-demo}
 
 想要部署演示并查看其实际效果吗？从这里开始：
 
 - [Docker](docker-deployment/)
 - [Kubernetes](kubernetes-deployment/)
 
-## 语言特性参考
+## 语言特性参考 {#language-feature-reference}
 
 想要了解特定编程语言的工具是如何工作的？从这里开始：
 
@@ -36,44 +35,41 @@ cSpell:ignore: OLJCESPC
 | Ruby       |                                      | [电子邮件服务](services/email/)                                                                             | [电子邮件服务](services/email/)                                            |
 | Rust       |                                      | [发货服务](services/shipping/)                                                                              | [发货服务](services/shipping/)                                             |
 
-## 服务文档
+## 服务文档 {#service-documentation}
 
 有关如何在每个服务中部署 OpenTelemetry 的具体信息可以在此处找到：
 
+- [记账服务](services/accounting/)
 - [广告服务](services/ad/)
 - [购物车服务](services/cart/)
-- [结账服务](services/checkout/)
-- [电子邮箱服务](services/email/)
-- [前端](services/frontend/)
+- [结算服务](services/checkout/)
+- [电子邮件服务](services/email/)
+- [前端服务](services/frontend/)
 - [负载生成器](services/load-generator/)
 - [支付服务](services/payment/)
 - [产品目录服务](services/product-catalog/)
 - [报价服务](services/quote/)
 - [推荐服务](services/recommendation/)
-- [发货服务](services/shipping/)
-- [图片提供商服务](services/image-provider/?i18n-patch)
+- [物流服务](services/shipping/)
+- [图像提供服务](services/image-provider/)
+- [React 原生应用](services/react-native-app/)
 
-## 应用场景
+## 应用场景 {#feature-flag-scenarios}
 
 如何使用 OpenTelemetry 解决问题？这些场景将引导你解决一些预先配置的问题，
 并向你展示如何解释 OpenTelemetry 数据来解决这些问题。
 
-随着时间的推移，我们将添加更多场景：
+## 参考资料 {#reference}
 
-- 使用功能标志服务为产品 ID 为 `OLJCESPC7Z` 的 `GetProduct` 请求生成[产品目录错误](feature-flags)
-- 发现内存泄漏并使用指标和追踪对其进行诊断，[阅读更多](feature-flags/recommendation-cache/)
-
-## 参考
-
-项目参考文档，例如需求和功能矩阵：
+项目的参考文档，包括需求和功能矩阵等内容：
 
 - [架构](architecture/)
 - [开发](development/)
-- [功能标志参考](feature-flags/)
+- [特性开关参考](feature-flags/)
 - [指标功能矩阵](telemetry-features/metric-coverage/)
-- [要求](./requirements/)
+- [需求说明](./requirements/)
 - [截图](screenshots/)
 - [服务](services/)
 - [Span 属性参考](telemetry-features/manual-span-attributes/)
 - [测试](tests/)
-- [Trace 功能矩阵](telemetry-features/trace-coverage/)
+- [链路追踪功能矩阵](telemetry-features/trace-coverage/)

content/zh/docs/demo/development.md

@@ -0,0 +1,68 @@
+---
+title: 开发
+default_lang_commit: 82eee93552827dde1e716a5e711935e876803914
+cSpell:ignore: grpcio intellij libcurl libprotobuf nlohmann openssl protoc
+---
+
+[OpenTelemetry Demo GitHub 仓库](https://github.com/open-telemetry/opentelemetry-demo)
+
+开发本演示项目需要使用多种编程语言的工具链。
+尽可能会注明所需的最低版本，但推荐为所有工具更新至最新版本。
+OpenTelemetry 演示团队将尽力使本仓库中的服务在可能的情况下始终使用依赖项和工具的最新版本。
+
+## 生成 protobuf 文件 {#generate-protobuf-files}
+
+提供了 `make generate-protobuf` 命令用于为所有服务生成 protobuf 文件。
+这个命令可以在本地编译代码（无需 Docker），并在 IntelliJ 或 VS Code 等 IDE 中获得代码提示。
+生成文件前，可能需要先在 frontend 源代码目录中运行 `npm install`。
+
+## 开发工具要求 {#development-tooling-requirements}
+
+### .NET
+
+- .NET 8.0+
+
+### C++
+
+- build-essential
+- cmake
+- libcurl4-openssl-dev
+- libprotobuf-dev
+- nlohmann-json3-dev
+- pkg-config
+- protobuf-compiler
+
+### Go
+
+- Go 1.19+
+- protoc-gen-go
+- protoc-gen-go-grpc
+
+### Java
+
+- JDK 17+
+- Gradle 7+
+
+### JavaScript
+
+- Node.js 16+
+
+### PHP
+
+- PHP 8.1+
+- Composer 2.4+
+
+### Python
+
+- Python 3.10
+- grpcio-tools 1.48+
+
+### Ruby
+
+- Ruby 3.1+
+
+### Rust
+
+- Rust 1.61+
+- protoc 3.21+
+- protobuf-dev

content/zh/docs/demo/forking.md

@@ -0,0 +1,27 @@
+---
+title: Fork 演示仓库
+linkTitle: 派生
+default_lang_commit: 82eee93552827dde1e716a5e711935e876803914
+---
+
+[演示仓库][demo repository]旨在被 Fork 使用，作为展示你如何使用 OpenTelemetry 的工具。
+
+设置一个 Fork 或演示环境通常只需要覆盖一些环境变量，并可能替换一些容器镜像。
+
+你可以将在线演示添加到该演示项目的
+[README](https://github.com/open-telemetry/opentelemetry-demo/blob/main/README.md?plain=1)
+中。
+
+## 给 Fork 维护者的建议 {#suggestions-for-fork-maintainers}
+
+- 如果你希望增强演示项目所生成或收集的遥测数据，我们强烈建议你将相关更改反向合并到此主仓库中。
+  对于厂商或实现特定的更改，建议采用通过配置文件在数据处理管道中修改遥测的方式，而不是更改底层代码。
+- 拓展而非替换。新增与现有 API 交互的新服务，是添加特定厂商或工具功能的良好方式，
+  尤其是在无法通过修改遥测实现目标的情况下。
+- 为了支持可拓展性，请使用仓库（Repository）或门面（Facade）模式来封装诸如队列、数据库、缓存等资源。
+  这样可以便于为不同平台替换或接入不同的实现。
+- 请不要尝试将特定厂商或工具的增强功能反向合并到主仓库中。
+
+如果你有任何问题，或者希望提出建议帮助我们更好地支持 Fork 维护者的工作，请提交一个 Issue。
+
+[demo repository]: <{{% param repo %}}>