farris-vue/CONTRIBUTING.md

2.7 KiB
Raw Blame History

Farris UI Vue 贡献指南

下面是参与贡献 Farris UI 的共享指南,请在反馈issuePull Request之前,花费几分钟阅读以下内容。 你也可以根据自己的实践经验,自由的通过Pull Reqeust修改完善这个指南。

反馈Issue

如有你认为自己新发现了一个bug或者提出一个新特性请先确定之前没有人提出或者修复过这个bug或者特性。你可以在Issues列表和PR列表中搜索是否有人已经提出了类似bug或者特性。

接下来你可以在Issue列表界面创建一个新的Issue我们为你提供了Issue模板请在Issue模板中标记是要反馈「bug」还是「新特性」并提供必须的上下文说明以便于开发者可以清晰的理解你的意图。

领取Issue

如果你对修复某个bug或者实现某个新特性敢兴趣请在这个Issue下方通过评论告诉我们我们可以进行充分沟通这个「bug」或者「新特性」的具体细节然后会将Issue的负责人指定给你将有你负责后续开发工作。 请务必首先认领Issue然后在在开启你的贡献工作。

贡献代码

如果你成功领取了项目Issue请通过Gitee推荐的「fork + pull request」的方式贡献代码。 为了保证项目代码质量,我们指定了详细的编码风格指南。 为了你的PR可以顺利通过代码审查请在编码前认真阅读以下编码指南

提交Pull Request

我们欢迎你通过提交PR参与项目贡献在你计划提交PR前请先阅读以下注意事项

  • 在你提交PR之前请确保已经开启了一个Issue并认领了它我们只接收与认领Issue关联的PR。如果你打算实现一个比较大的特性在开启新的Issue前最好先与项目管理者进行充分讨论。

  • 在没有十足把握时尽量提交小规格的PR。不要在一个PR中修复多于一个bug或实现多于一个新特性以便于更容易被接受。提交两个小规模的PR会比提交一个大规模修改的PR要好。

  • 当你提交新特性,或者修改已有特性时,请包含相应的测试代码,以便于确认组件新的交互特性。

  • 在提交PR前端请先执行Rebase以便于保持干净的历史提交记录。

  • 我们提供了PR模板请在提交PR时安装模板要求提供「修改的内容」、「管理的PR」、「测试用例」、「界面预览」等相关内容。

Creative Commons License