Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
aab9c33e
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
aab9c33e
编写于
11月 03, 2021
作者:
W
wusongqing
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
updated docs
Signed-off-by:
N
wusongqing
<
wusongqing@huawei.com
>
上级
68b2da8e
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
244 addition
and
0 deletion
+244
-0
en/contribute/docs-release-process.md
en/contribute/docs-release-process.md
+122
-0
en/contribute/figures/docs-release-process.md
en/contribute/figures/docs-release-process.md
+122
-0
未找到文件。
en/contribute/docs-release-process.md
0 → 100644
浏览文件 @
aab9c33e
# 为发行版本撰写配套文档
为了帮助开发者更高效使用OpenHarmony社区的每个Release版本,社区会根据每个版本规划的需求特性提供配套文档(如指南、API参考、开发示例、Release Notes、API Changelog、FAQ等)。有的需求涉及新增功能特性和文档,有的需求的是对现有特性和文档内容更新。
## OpenHarmony社区文档开发流程
每个SIG团队在规划功能特性需求时,需要判断该需求是否涉及新增开发者文档、或变更现有开发者文档,分解需求给SIG Docs 团队,便于文档需求跟踪闭环。SIG Docs团队会根据相关需求,提供文档设计意见,并配合各业务SIG团队完成开发者文档的评审、翻译和发布。社区文档完整开发流程如下:
![
OpenHarmony社区文档开发流程
](
figures/docs-sig.png
)
## 业务SIG团队成员或其他开发人员
通过每个业务SIG团队为发行版本撰写配套文档基础稿,欢迎社区开发人员参与相关功能特性文档开发。
### 分解文档需求
1.
在业务SIG需求Issue中给出【配套文档】的分解,如果涉及开发者文档新增、更新,需要关联SIG-Docs。
2.
在
[
OpenHarmony社区版本发布计划
](
https://gitee.com/openharmony/release-management/blob/master/OpenHarmony-RoadMap.md
)
中查看对应版本的特性需求,此文档中给出了OpenHarmony的版本发布时间计划、各版本交付特性、特性状态,所属SIG。
如果该特性需求涉及文档交付,需要在对应的Need Docs列补充判断,SIG_Docs,便于SIG Docs团队闭环跟踪文档交付。
### 开发文档
如果你是某个业务SIG的成员,负责开发某一新特性,你需要与SIG Docs一起配合,确保在版本发布之前完成该新特性文档开发。否则,在最终的版本发布中未提供配套文档的特性可能被移除。
如果你需要文档组织方面的帮助,请在
`#SIG-Docs`
ZULIK频道中提问求助。
1.
参考
[
评审人沟通表
](
docs-reviewers.md
)
,联系SIG Docs资料作者,沟通文档设计建议。
2.
获取
[
文档模板
](
template
)
,了解文档写作规范。
3.
尽可能为功能特性提供详细的文档及使用说明,完成功能特性初稿后,提交PR并在PR描述中提供对应的需求Issue链接。
### 提交PR评审
所有新增内容的PR评审,为确保技术描述准确性需要指定相应业务SIG的技术专家参与技术评审,同时指定SIG Docs的资料专家评审文档规范性内容,请参考
[
评审人沟通表
](
docs-reviewers.md
)
在PR评论区@相关专家。也可以在
`#SIG-Docs`
ZULIK频道中反馈评审需求。
在评审周期内,所有评审意见闭环修改后,该PR通过审核可以合并入仓的必要条件:
-
技术评审专家审核后给出
`TechApprove`
的评论。
-
文档规范性评审专家审核后给出
`DocsApprove`
的评论。
### 提交测试
文档随版本转测试,测试过程中的文档问题,由SIG Test团队测试人员以Issue形式提交到Docs仓,对应文档作者闭环确认测试意见并完成文档修改。
### 提交翻译
#### Docs仓文档翻译
OpenHarmony社区为开发者提供中文、英文的官方文档,中文文档完成评审、测试定稿后,可提交翻译需求Issue,由SIG Docs团队的翻译专家完成英文文档。
翻译专家通过PR提交英文文档,并在PR描述中提供对应的中文需求Issue链接。为确保技术翻译描述准确性需要指定相应业务SIG的技术专家参与技术评审,可以是中文文档作者,请参考
[
评审人沟通表
](
docs-reviewers.md
)
在PR评论区@相关专家。
在评审周期内,所有评审意见闭环修改后,该PR通过审核可以合并入仓的必要条件:
-
技术评审专家审核后给出
`TechApprove`
的评论。
-
英文文档规范性评审专家审核后给出
`DocsApprove`
的评论。
#### 非Docs仓文本类翻译
针对OpenHarmony核心业务SIG的非Docs仓翻译需求(如API注释等),可提交翻译需求Issue到Docs仓,SIG Docs团队的翻译专家完成英文文档交付。
提交翻译需求时,需确保:
1.
相关中文文档为发布交付件质量标准。
2.
提供中文文档PR或相关文档路径。
3.
中文临时文件可提交至
[
SIG-Docs仓
](
https://gitee.com/openharmony/community/tree/master/sig/
)
。
## Docs SIG团队成员或文档贡献者
SIG Docs团队成员或文档贡献者或,配合各业务SIG团队,评审、优化相关文档输出,英文翻译,确保相关输出符合发布条件。
### 了解发行版本规划特性
想要了解对应发行版本规划的功能特性、发布计划,可以参加每双周周五例行组织的
[
SIG Release
](
https://gitee.com/openharmony/release-management/blob/master/README.md
)
例会。了解版本进度,需求交付进度,文档交付进度等。
同时可以在
[
OpenHarmony社区版本发布计划
](
https://gitee.com/openharmony/release-management/blob/master/OpenHarmony-RoadMap.md
)
中查看对应版本的特性需求,选择标识有SIG_Docs的相关特性Issue,及关联的文档PR。
![
版本特性清单
](
figures/sig-task.png
)
### 评审PR中提交的中文文档
在评审对应特性文档时,建议从以下方面给出中肯的评审建议。
#### 语言描述规范
-
前后逻辑表达通顺,术语名词表述一致
-
语言正式避免口语化
-
避免使用侵犯第三方知识产权的风险词汇
#### 内容易理解
-
内容逻辑清晰,前后表达一致
-
内容表达易读易理解,避免使用晦涩、生僻的词语
-
步骤清晰,有效指导开发者完成相关任务开发
#### 图表规范
-
图片清晰、图文配合使用
-
表格有表头、表标题,避免出现单行或单列表
-
表格中无内容用“-"或者"NA",避免出现空白单元格
#### 网站风格
-
该PR变更涉及新增Markdown页面时,需确保:
-
该页面内容使用了正确的内容模板
-
该Markdown文件名称定义符合规范
-
该页面在整本手册Readme导航中正常显示
-
删除Markdown页面、变更Markdown页面名称,需确保:
-
该页面对社区其他内容链接未产生影响,建议本地运行链接检查
-
整本手册Readme导航中更新目录
更多详细规范请参考OpenHarmony社区文档
[
写作规范
](
写作规范.md
)
。
### 翻译英文文档
社区的翻译需求Issue会由SIG Docs团队技术翻译专家完成翻译,也欢迎文档贡献者领取翻译需求任务,提交英文文档PR。
en/contribute/figures/docs-release-process.md
0 → 100644
浏览文件 @
aab9c33e
# 为发行版本撰写配套文档
为了帮助开发者更高效使用OpenHarmony社区的每个Release版本,社区会根据每个版本规划的需求特性提供配套文档(如指南、API参考、开发示例、Release Notes、API Changelog、FAQ等)。有的需求涉及新增功能特性和文档,有的需求的是对现有特性和文档内容更新。
## OpenHarmony社区文档开发流程
每个SIG团队在规划功能特性需求时,需要判断该需求是否涉及新增开发者文档、或变更现有开发者文档,分解需求给SIG Docs 团队,便于文档需求跟踪闭环。SIG Docs团队会根据相关需求,提供文档设计意见,并配合各业务SIG团队完成开发者文档的评审、翻译和发布。社区文档完整开发流程如下:
![
OpenHarmony社区文档开发流程
](
figures/docs-sig.png
)
## 业务SIG团队成员或其他开发人员
通过每个业务SIG团队为发行版本撰写配套文档基础稿,欢迎社区开发人员参与相关功能特性文档开发。
### 分解文档需求
1.
在业务SIG需求Issue中给出【配套文档】的分解,如果涉及开发者文档新增、更新,需要关联SIG-Docs。
2.
在
[
OpenHarmony社区版本发布计划
](
https://gitee.com/openharmony/release-management/blob/master/OpenHarmony-RoadMap.md
)
中查看对应版本的特性需求,此文档中给出了OpenHarmony的版本发布时间计划、各版本交付特性、特性状态,所属SIG。
如果该特性需求涉及文档交付,需要在对应的Need Docs列补充判断,SIG_Docs,便于SIG Docs团队闭环跟踪文档交付。
### 开发文档
如果你是某个业务SIG的成员,负责开发某一新特性,你需要与SIG Docs一起配合,确保在版本发布之前完成该新特性文档开发。否则,在最终的版本发布中未提供配套文档的特性可能被移除。
如果你需要文档组织方面的帮助,请在
`#SIG-Docs`
ZULIK频道中提问求助。
1.
参考
[
评审人沟通表
](
docs-reviewers.md
)
,联系SIG Docs资料作者,沟通文档设计建议。
2.
获取
[
文档模板
](
template
)
,了解文档写作规范。
3.
尽可能为功能特性提供详细的文档及使用说明,完成功能特性初稿后,提交PR并在PR描述中提供对应的需求Issue链接。
### 提交PR评审
所有新增内容的PR评审,为确保技术描述准确性需要指定相应业务SIG的技术专家参与技术评审,同时指定SIG Docs的资料专家评审文档规范性内容,请参考
[
评审人沟通表
](
docs-reviewers.md
)
在PR评论区@相关专家。也可以在
`#SIG-Docs`
ZULIK频道中反馈评审需求。
在评审周期内,所有评审意见闭环修改后,该PR通过审核可以合并入仓的必要条件:
-
技术评审专家审核后给出
`TechApprove`
的评论。
-
文档规范性评审专家审核后给出
`DocsApprove`
的评论。
### 提交测试
文档随版本转测试,测试过程中的文档问题,由SIG Test团队测试人员以Issue形式提交到Docs仓,对应文档作者闭环确认测试意见并完成文档修改。
### 提交翻译
#### Docs仓文档翻译
OpenHarmony社区为开发者提供中文、英文的官方文档,中文文档完成评审、测试定稿后,可提交翻译需求Issue,由SIG Docs团队的翻译专家完成英文文档。
翻译专家通过PR提交英文文档,并在PR描述中提供对应的中文需求Issue链接。为确保技术翻译描述准确性需要指定相应业务SIG的技术专家参与技术评审,可以是中文文档作者,请参考
[
评审人沟通表
](
docs-reviewers.md
)
在PR评论区@相关专家。
在评审周期内,所有评审意见闭环修改后,该PR通过审核可以合并入仓的必要条件:
-
技术评审专家审核后给出
`TechApprove`
的评论。
-
英文文档规范性评审专家审核后给出
`DocsApprove`
的评论。
#### 非Docs仓文本类翻译
针对OpenHarmony核心业务SIG的非Docs仓翻译需求(如API注释等),可提交翻译需求Issue到Docs仓,SIG Docs团队的翻译专家完成英文文档交付。
提交翻译需求时,需确保:
1.
相关中文文档为发布交付件质量标准。
2.
提供中文文档PR或相关文档路径。
3.
中文临时文件可提交至
[
SIG-Docs仓
](
https://gitee.com/openharmony/community/tree/master/sig/
)
。
## Docs SIG团队成员或文档贡献者
SIG Docs团队成员或文档贡献者或,配合各业务SIG团队,评审、优化相关文档输出,英文翻译,确保相关输出符合发布条件。
### 了解发行版本规划特性
想要了解对应发行版本规划的功能特性、发布计划,可以参加每双周周五例行组织的
[
SIG Release
](
https://gitee.com/openharmony/release-management/blob/master/README.md
)
例会。了解版本进度,需求交付进度,文档交付进度等。
同时可以在
[
OpenHarmony社区版本发布计划
](
https://gitee.com/openharmony/release-management/blob/master/OpenHarmony-RoadMap.md
)
中查看对应版本的特性需求,选择标识有SIG_Docs的相关特性Issue,及关联的文档PR。
![
版本特性清单
](
figures/sig-task.png
)
### 评审PR中提交的中文文档
在评审对应特性文档时,建议从以下方面给出中肯的评审建议。
#### 语言描述规范
-
前后逻辑表达通顺,术语名词表述一致
-
语言正式避免口语化
-
避免使用侵犯第三方知识产权的风险词汇
#### 内容易理解
-
内容逻辑清晰,前后表达一致
-
内容表达易读易理解,避免使用晦涩、生僻的词语
-
步骤清晰,有效指导开发者完成相关任务开发
#### 图表规范
-
图片清晰、图文配合使用
-
表格有表头、表标题,避免出现单行或单列表
-
表格中无内容用“-"或者"NA",避免出现空白单元格
#### 网站风格
-
该PR变更涉及新增Markdown页面时,需确保:
-
该页面内容使用了正确的内容模板
-
该Markdown文件名称定义符合规范
-
该页面在整本手册Readme导航中正常显示
-
删除Markdown页面、变更Markdown页面名称,需确保:
-
该页面对社区其他内容链接未产生影响,建议本地运行链接检查
-
整本手册Readme导航中更新目录
更多详细规范请参考OpenHarmony社区文档
[
写作规范
](
写作规范.md
)
。
### 翻译英文文档
社区的翻译需求Issue会由SIG Docs团队技术翻译专家完成翻译,也欢迎文档贡献者领取翻译需求任务,提交英文文档PR。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录