docs: organize PR articles by date and version tag

This commit is contained in:
mesalogo
2026-09-16 16:35:44 +08:00
parent cc9ea7c718
commit 441f14b5f7
+18 -3
View File
@@ -87,17 +87,28 @@ tag 与当前 HEAD;明确记录基线 tag、目标提交和检查日期。Agen
## 交付与发布核对
用户指定位置时按指定位置交付,否则将本轮材料放在
`docs/pr-articles/drafts/<日期>-<主题>/`。目录只包含本轮文章与必要素材,不改产品代码。
文章及草稿统一归档在工作流所在目录下,使用
`docs/pr-articles/YYYY-MM-DD-<版本tag>/`,例如 `docs/pr-articles/2026-09-16-v0.13.6/`。
日期采用本轮材料首次建立的日期;版本 tag 指文章介绍的目标版本,不是比较区间的起点。
Agent 专题使用对应的 `agent-v…` tag。
草稿与正式稿沿用同一目录,不再单设 `drafts/`;发布时更新正文和状态,保留图片相对路径,
方便整目录交付与传播。目录名不表示版本已经发布,实际状态记录在 `review.md`。
目标版本尚未确定时暂用 `YYYY-MM-DD-unreleased/`,确定后改为目标 tag 并更新文档链接,
不能自行推测下一版本号。同一版本同一天有多篇文章时,在该目录内按主题建立子目录。
目录只包含本轮文章与必要素材,不改产品代码。
最小交付:
- `article.md`:文章标题、正文、相对路径配图和图注。
- `assets/`:实际取得的图片;如有处理,保留可区分的原图。
- `review.md`:比较区间、选题理由、事实来源、截图环境与步骤、验证范围和待补事项。
- `review.md`:草稿/待发布/已发布状态、目标 tag 与提交、比较区间、选题理由、事实来源、
截图环境与步骤、验证范围和待补事项;外部发布后补充发布日期与链接。
没有图片时不建空目录。文章草稿中的素材占位必须醒目标注;发布用正文不得留下占位文字。
内部验证细节和编辑备注放在 `review.md`,不混入面向用户的宣传正文。
新增文章目录时,在本页末尾的文章索引登记日期、目标 tag、标题、状态及正文链接;
正式发布后同步更新状态和外部链接。对外传播正文与所需图片,不附内部核查记录。
交付前检查图片可读、相对路径存在、文章与图片一致、标题没有超出功能事实。
发布前再次确认对应版本可下载、下载链接有效、升级说明准确,且最终版本没有改变演示行为。
@@ -105,3 +116,7 @@ tag 与当前 HEAD;明确记录基线 tag、目标提交和检查日期。Agen
最终回复提供文章和素材位置,概括推荐主题、实际截图情况及剩余阻碍。
只有得到明确发布指令后,才通过可用平台能力执行外部发布;准备文章不等于授权发布。
## 文章索引
尚无归档文章。创建首篇草稿后,以日期、版本 tag、标题、状态、正文链接和发布链接建立索引表。