xxx系统/模块
注意:
1、本模板提供推荐的README写作指导。
2、所有斜体为写作指导,正式文档中注意全部删除。
【总体写作要求】
1、确认写作内容:介绍系统/模块是什么(What)、能做什么(Why),以及如何进行开发(How)。
2、变身用户视角:以开发者视角,提供开发者关注的 和需要使用的内容。
3、不要受限:模板供参考,根据实际情况灵活调整。
简介
【写作要求】必选
**内容介绍:**在整个 TuyaOpen 架构中的作用、实现的功能、使用场景、支持的设备等。
注意事项如下:
要求项 | 内容要求 |
---|---|
1 | 用语要求 |
1.1 | 行文风格:用语正式,避免口语化。 |
1.2 | 合规要求:不能使用第三方知识产权特有概念等存在合规和法务风险的词汇。 |
1.3 | 用语一致:术语与术语库保持一致,正文中缩略语首次出现要给出全称。 |
2 | 格式要求 |
2.1 | 标点符号正确,一句话结束以句号结尾。 |
2.2 | 内容尽量用项目列表或分类的方式清晰呈现。 |
2.3 | 如果是内容的辅助说明,请使用“说明/注意/警告”式样。 |
3 | 表格 |
3.1 | 表格有表头,表格无内容用“不涉及/无”,不出现空白的单元格。 |
4 | 截图 |
4.1 | 图形逻辑清晰,图文配合使用。 |
4.2 | 建议为.png格式。 |
4.3 | 中文图用中文,英文图用英文。 |