-
Notifications
You must be signed in to change notification settings - Fork 314
组件 demo 和 api 文档编写规范
Kagol edited this page Dec 4, 2023
·
2 revisions
把自己当成小白用户,去体验,去优化。
API 文档:
- api表格列字段统一 props / events / slots / methods
- 描述格式美化
- props类型明确、事件参数类型明确、插槽数据类型明确、method参数和返回值类型明确
- api顺序按照首字母顺序排列,符合预期
- demo跳转正确
- 消除错别字、重复、不对应的内容
Demo 文档:
- demo设计要合理,按特性进行分类,相同的特性整合到一个demo中,适当地通过在demo中增加切换功能
- demo说明需要清晰
- demo代码去除多余的干扰代码、重复代码
- 整改不符合规范的demo示例代码,不写行内样式
- 按照使用频率高低来设置demo顺序,确保高频使用的特性demo放前面
- 测试playground跳转后是否正常
- demo标题命名规则统一
- 识别组件问题
- Options/Composition写法的demo都应该有
- 语句末尾(除了api部分,即表格的中文描述不需要加)都需要增加句号 。
- 中英文混杂的部分英文两边需要增加一个空格
- demo 中的内容不能太拥挤
其他:
- 组件demo里有一些是
设置xxx
或者xxx 设置
的,可直接写成 xxx ,不要加设置
的字样,因为demo就是演示各种功能和api的设置/配置。比如 设置尺寸 改成 尺寸 - api的默认值为空可以用 --
- ...(欢迎补充)