aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorQGrain <zhiyuzhang999@gmail.com>2025-10-14 01:53:43 +0800
committerAleksandr Nogikh <nogikh@google.com>2025-10-15 12:07:22 +0000
commit82df6b00ffc5014c260a28083893a8a0498bcdd3 (patch)
tree48d8a1d4955853773e388b03b18e04d8bb41c552
parent6388bfeadb2507da7ed1f1238c9147d738a8d9d4 (diff)
docs/translations: add the translation of maintaining.md
Finish the translation of docs/maintaining.md, which has been proofread by HCTT. Update to commit 0773c42 ("docs: fix misspellings").
-rw-r--r--docs/translations/zh_CN/maintaining.md39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/translations/zh_CN/maintaining.md b/docs/translations/zh_CN/maintaining.md
new file mode 100644
index 000000000..fafe1b004
--- /dev/null
+++ b/docs/translations/zh_CN/maintaining.md
@@ -0,0 +1,39 @@
+> [!WARNING]
+>
+> **请注意,这是社区驱动的官方 syzkaller 文档翻译。当前文档的最新版本(英文版)可在 [docs/maintaining.md](/docs/maintaining.md) 中找到。**
+
+# 维护者指南
+
+## 线性历史
+
+我们保持线性历史记录,并在仓库设置中禁用合并提交(merge commit)。
+拉取请求(PR)仅有两个选项:
+- **变基合并(Rebase and merge)**\
+ 若 PR 中的所有提交已妥善整理/修复,优先选择此方式,
+ 因其保留 PR 中的提交记录(将 PR 中的所有提交直接添加至 master 分支的最新提交之上)。
+- **压缩合并(Squash and merge)**\
+ 若 PR 包含分散的修正提交或提交组织混乱时优先选择此方式
+ (将 PR 中的所有提交压缩为单个提交并添加至 master 分支的最新提交之上,同时允许编辑提交主题/描述)。
+
+## PR 检查 (CI)
+
+合并前需通过 `cla/google` 检查。
+
+合并前通常需通过所有 CI 测试。\
+例外情况包括基础设施偶发问题(尤其是外部服务:`codecov`、`ci/fuzzit`)
+以及偶现的超时/内存溢出(但若 PR 本身显著增加此类问题频率则不可豁免)。所有静态检查警告和测试错误均视为严重问题。
+
+## 测试
+
+原则上鼓励为新代码和错误修复添加测试。应要求贡献者补充测试。
+
+但不同代码的测试难度存在差异。
+以下情况更易添加测试(建议补充):无外部依赖的抽象功能(如解析器、数据转换、计算逻辑);已有成熟测试基础设施的代码(添加新测试仅需遵循现有模式)。
+以下情况测试难度较高(可不强制要求,但仍欢迎补充):存在难以模拟的外部依赖的代码(qemu、内核、镜像等);缺乏现成测试基础设施,需先构建整套框架才能添加测试的代码。
+
+## 善用判断力
+
+当前暂无严格的审查/所有权规则,请灵活运用判断力。
+
+若您负责项目的特定领域(如某操作系统的支持),可自行合并变更而无需额外审查(尤其小型变更且 CI 通过时)。
+亦可审查并合并项目其他部分的变更。若信心不足或需要额外意见,请与其他维护者协同处理。