docs 版本相关文档索引(全目录)

维护者按 P0 → P1 → P2 处理;有英文对应路径的必须成对改(见 locale-map.mdbilingual-sync.md)。

扫描根目录docs/.md 文件**(含 zh-cnenSamples//README*.md`)。

文件类型:本 skill 只改 .md。禁止改 package.jsonjson5js/ts.tgzCMakeLists.txt、图片等。工程文件由维护者单独升级。

版本真源 → 文档写法(真源只读)

真源字段 release note / 版本索引 依赖示例 / JSON 代码块 / Samples README
peerDependencies.react-native 精确号 0.84.1 0.84.xx
react-native-harmony.version 精确号 0.84.xx
react-native-harmony-cli.version 精确号 0.84.xx
package.jsonreact JSON 示例随 RN 版本线

P0 — 每次发布(中英成对)

路径 版本绑定 patch major 英文对应
zh-cn/05-运维/版本说明.md 版本列表 增条目 更新当前 en/05-operations/release-notes-overview.md
*/05-*/release-notes/react-native-harmony-v*.md 单版本说明 新建+删旧patch 新建 zh + en 各一份,结构对齐
zh-cn/02-开发/01-环境与工具/环境搭建.md init、package 示例 改号用 0.84.xx 工具链段 en/.../environment-setup.md
zh-cn/02-开发/01-环境与工具/SDK版本配置指导.md SDK 配置 按需 常改 en/.../SDK version configuration guide.md

P1 — 强烈建议(中英成对)

路径(zh-cn 为主) patch major 英文对应
05-运维/版本升级指导.md 示例号 新章节+JSON version-upgrade-guide.md
05-运维/上游社区不兼容变更.md 追加 upstream-community-incompatible-changes.md
05-运维/RN-JS打包.mdhvigorfile配置.md 按需 按需 见 locale-map
02-开发/02-开发指南/Codegen.md 示例号 常改 同名 en
02-开发/02-开发指南/TurboModule.md 示例号 常改 同名 en
02-开发/02-开发指南/Autolinking.md 按需 常改 autolinking.md
02-开发/02-开发指南/编译构建/*.md 按需 常改 见 locale-map
06-社区/roadmap.md 状态 规划表 同名 en
06-社区/社区规范/社区issue管理规范.md placeholder placeholder 若有英文规范
06-社区/开发者文档共建指南.md +v0.XX documentation-contribution-guide.md
05-运维/README.mdzh-cn/README.mden/README.md 导航 导航 成对
en/.../getting-started.md 与 setup 一致 常大改 仅 en

仅中文(改中文 + 报告标注缺口)

路径 说明
05-运维/RN升级需要开发者适配整理.md 英文 FAQ 仅链中文
02-开发/03-场景与实践/RN应用鸿蒙化开发指南.md 大版本常全文改
02-开发/02-开发指南/编译构建/RNOH包使用指南.md 待英文

P1 — docs/Samples(README*.md)

路径 说明
docs/Samples/**/README.mdREADME_zh.md 依赖安装 0.84.xx;major 时 0.82.xx0.84.xx0.84.1

禁止修改(docs/Samples 及全 docs)

路径 / 模式 原因
一切非 .md 文件 本 skill 只改 Markdown
**/package.json**/oh-package.json5 示例工程单独维护
**/hvigor-config.json5、构建配置、.tgz 工程配置
README 步骤正文、有序列表编号 非版本绑定

不在本 skill 范围内

以下如需更新,由维护者另开任务,不在文档版本升级 PR 中修改:

  • docs/templates/**(含 package.json、鸿蒙模板)
  • docs/**/figures/**(截图,除非文档步骤变更且用户明确要求)
  • packages/CHANGELOG.md、示例工程源码

P2 — grep 驱动

区域 典型文件 双语
03-调测/03-debugging/ 编译/运行/规格 FAQ 成对
02-开发/03-场景与实践/使用类FAQ.md Hermes、依赖示例 usage-faqs.md
01-设计/规格类FAQ.md 历史升级说明 可保留旧号
05-运维/AI辅助问题定位指导.md 示例版本列表 成对
en/**/common-development-scenarios.md 移除过时 WARNING 与中文场景一致

稳定性(有修复才动)

路径 说明
zh-cn/05-运维/稳定性历史修复/{72,77,82,84}*/ 只追加,不改历史条目版本列
zh-cn/05-运维/稳定性skill/.../history-index.md 新主题/版本边界

通常不因改号而改

  • 01-设计/ 架构类(除 API 废弃注)
  • 04-调优/04-optimization/
  • 05-运维/稳定性编码规范/
  • 06-社区/社区changelog规范.md

扫描正则(在 docs/ 执行,限定 *.md

{OLD} 替换为实际上一版本:

rg "{OLD_RNOH}" docs/ -g "*.md"
rg "{OLD_RN}" docs/ -g "*.md"