依据 #34 对齐 SPIRE 阶段状态并明确状态查询前的沟通规则
This commit is contained in:
+11
-1
@@ -1,5 +1,15 @@
|
||||
# 文档维护规则
|
||||
|
||||
## 查询前先对齐
|
||||
|
||||
查询项目状态前,先询问维护者正在进行的工作、跟踪 ticket 和尚未成文的现状。
|
||||
已有明确授权则在该范围内继续,不重复询问;文档查询授权不自动扩展为现场检查。
|
||||
2026-09-16 维护者指定 SPIFFE/SPIRE 基本以 homelab-infra #34 的记录为依据;
|
||||
本轮仅查该 ticket 及其直接引用的 runbook,没有查询现场。其他项目仍需先询问。
|
||||
|
||||
稳定设计与使用方法放知识库,动态进度链接到 ticket。知识库只保留注明查阅日期的阶段摘要,
|
||||
不复制维护第二份实时任务列表。issue open 可能表示后续阶段未完成,不能据此推断基础服务未部署。
|
||||
|
||||
## 状态与证据
|
||||
|
||||
分别记录服务生命周期和验证程度,避免一个“完成”掩盖多个状态:
|
||||
@@ -16,7 +26,7 @@ accepted 不代表部署完成,implemented 必须附实现和验收依据。
|
||||
|
||||
## 一项工作的完成条件
|
||||
|
||||
1. 修改前读取服务文档及相关约束,检查已知冲突。
|
||||
1. 先按上述规则对齐查询范围,再读取服务文档、相关 ticket 和约束,区分动态工作与事实冲突。
|
||||
2. 实施和必要验证后,同步用途、入口、使用方法、依赖和恢复步骤中的变化。
|
||||
3. 新增或退役服务时更新服务总览;退役文档保留替代入口和原因。
|
||||
4. 代码与文档分属仓库时互相链接 commit/PR;未部署或未同步的部分明确写出。
|
||||
|
||||
Reference in New Issue
Block a user