同步操作将从 OpenHarmony/docs 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
本文介绍OpenHarmony文档贡献的写作规范。
如需提交新的文档,在Gitee上工程代码doc目录下创建新的.md文件,命名需遵循xxx-xxx.md格式,根据文档的内容来声明。
比如介绍写作规范的文档,可以命名为write-standard.md。
以简洁、直观地表达所述内容为目的,介绍性文档言简意赅介绍原理、架构、设计思路等,操作类文档写明关键步骤,以便能对其他开发者起到帮助。可以优先使用中文,建议中英文都支持,OpenHarmony也将持续更新,保证中英文的同步。
标题
建议标题层级不超过三级。
操作类文档标题尽量用动宾结构,执行的主体要描述清楚。(例如:申请权限)
正文
操作类文档以移植为例,文档结构可以参考如下:
目的(简述操作目的,如移植到哪款型号的单板)
软硬件环境准备
移植具体步骤
结果验证
步骤写作要求:
介绍性文档以开发指南某一功能为例,文档结构可以参考如下:
概述(概念及原理介绍)
功能(支持的接口列表)
开发流程(如何使用及相应步骤)
编程实例(提供具体代码示例)
注意事项
图片
图片统一存放到文档同级目录下的pic文件夹中(英文文档对应pic-en),如:
“OpenHarmony_DOCUMENTS/docs/quick-start/write-standard.md“中使用的图片,统一放置到
“OpenHarmony_DOCUMENTS/docs/quick-start/pic“目录下,文档中使用相对路径引用图片。
注意: 请使用原创图片,避免存在知识产权侵权风险。
说明: 引用方式: ![](./pic/pic-standard.png)
如果是自制图片,配色请参考如下,格式不限png/jpg/gif...均可。
如果是截图请参考如下,如需突出图形中的关键信息,可增加红色框线或者文字备注说明。
线条宽度:0.75pt
线条颜色:CE0E2D
中文字体:微软雅黑
英文字体:首选Arial
字体大小:10pt
表格
在md中可以按照如下形式插入表格。
Input
| Tables | Type | Note |
| ----------- |:-------------:| -----:|
| first | standard | None |
| second | outstanding | 5 |
| third | inside | with |
Output
表 1 参数表
代码
代码示例说明了如何实现特定功能,开发人员使用代码示例来编写和调试代码。代码要求如下:
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。