贡献文档¶¶
非常欢迎您贡献文档,我们鼓励开发者以各种方式参与文档反馈和贡献。您可以对现有文档进行评价、简单更改、反馈文档质量问题、贡献您的原创内容。
内容版权¶¶
用户提交的内容、图片必须是原创内容,不得侵犯他人知识产权。
License¶¶
Creative Commons License version 4.0
贡献方式¶¶
反馈文档问题¶¶
高质量的问题反馈有助于我们不断完善文档内容和质量,您提供的信息越详尽,对我们问题改进越有帮助。
- 在Gitee页面中,“Issue”页签中单击“新建Issue”,在标题栏中描述问题,在编辑框中添加详细问题描述。
- 单击“创建”按钮,提交Issue,耐心等待文档团队成员确认您的问题。
说明: 如何反馈一个高质量的问题?
- 提供问题的清晰描述,描述具体缺失、过时、错误的内容或者需要改进的文字。
- 解释该问题对用户的影响。
- 将给定问题的范围限定在一个具体内容、任务。如果问题牵涉的领域较大,可以将其分解为多个小一点的问题。例如:“文档需要优化” 是一个过于宽泛的问题,而 “XX开发指南缺少对XXX步骤的介绍” 就是一个足够具体的、可操作的问题。
- 搜索现有问题的列表,查看是否已经有相关的或者类似的问题已被记录。
- 如果新问题与某其他问题或PR有关联,可以使用其完整 URL 或带 # 字符的PR编号来引用它。
简单更改¶¶
针对现有文档进行快速更改和修复,适合少量内容修改和补充。
- 在文档页面右上角单击“编辑“按钮即可跳转到对应的Gitee工程源文件页面。
- 在Gitee源文件md页面中,在对应内容处完成更改、修复。
- 修改完成后,可单击“预览“按钮,确认修改结果。
- 确认无误后,在“扩展信息框”中填写修改意见和补充信息、Signed-off-by邮箱信息触发DCO校验,单击提交审核。
例如:Signed-off-by: user.name //与DCO签署邮箱保持一致
文档团队成员将评审并合并您的修改内容,感谢您对Dancehole文档的支持和帮助。
更多内容可参考贡献流程。
为发行版本贡献文档¶¶
为了帮助开发者更高效使用Dancehole开发的每个Release版本,社区会根据每个版本规划的需求特性提供配套文档(如指南、API参考、开发示例、Release Notes、API Changelog、FAQ等)。有的需求涉及新增功能特性和文档,有的需求是对现有特性和文档内容更新。
欢迎开发者参与贡献,详细参考:为发行版本贡献文档
PR建议¶¶
- 使用项目的代码风格,无意义 修改风格 无具体功能的代码不会被接受。
- 修bug,加功能,请同步测试和更新文档
- 建议跑完整测试
- PR描述清楚,可优先解决issue的问题
- 建议开发者未回复3-5天在ping,增加效率