docs 版本相关文档索引(全目录)
维护者按 P0 → P1 → P2 处理;有英文对应路径的必须成对改(见 locale-map.md、bilingual-sync.md)。
扫描根目录:docs/ 下 .md 文件**(含 zh-cn、en、Samples//README*.md`)。
文件类型:本 skill 只改 .md。禁止改 package.json、json5、js/ts、.tgz、CMakeLists.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.json → react |
— |
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打包.md、hvigorfile配置.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.md、zh-cn/README.md、en/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.md、README_zh.md |
依赖安装 0.84.xx;major 时 0.82.xx→0.84.xx;勿写 0.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"