写点什么

gitee 上提交 PR 和 issue 流程和注意事项

用户头像
Geek_6cdeb6
关注
发布于: 刚刚
gitee上提交PR和issue流程和注意事项

MindSpore 已在 Gitee 和 GitHub 上开源,所有人都可参与~

作为社区贡献的主要途径之一,Gitee 上提交 PR 还是有很多小伙伴不熟悉的,通过前两次活动我们也发现了这一问题,为此写了这篇注意事项,希望给大家作参考,同时期待大家的补充与指正!

Gitee:https://gitee.com/mindspore

GitHub:https://github.com/mindspore-ai


写在最前面,参与贡献必须先签署 CLA,具体方法请参考下方的“规范”

流程:

提交 issue

进入 MindSpore 相应的仓,这里我们以主仓 mindspore 为例。

进入主仓https://gitee.com/mindspore/mindspore(注意是进入主仓,不是自己 fork 下来的仓)

在下图位置点击”+issue"


填写 issue 详细描述和标题,点击创建。(issue 描述建议以英文为主)

issue 需要填写负责人,参考活动帖的“注意事项”,每次活动会发布负责人。


提交 PR

提交流程不熟悉的,可以参考这两篇文章。

《git + gitee 入门实践》

(包含 git 安装,简单使用,代码托管等内容)

git+码云提交PR流程记录

(本地新建代码仓、拉取远程代码仓内容、提交到远程仓库,提交 PR 等内容)

git 解冲突流程

(发生冲突时看这里!)

PR 需要填写审核人,参考活动帖的“注意事项”,每次活动会发布审核人。


规范:

主要参考《贡献文档》,以下几点为现有问题总结:


1.     CLA 签署问题,新人需签署 CLA。(基本前提,很重要!

签署方法:

1)在自己的 PR 下评论:/check-cla,短暂等待后,自动回复弹出,点击“here”(如下图)。或者直接访问:https://clasign.osinfra.cn/sign/Z2l0ZWUlMkZtaW5kc3BvcmU=


2)根据身份选择签署,外部用户一般签署第三个“个人 CLA”


3)填写带“*”号的内容并打勾,签署成功。(没绑定邮箱的需要去 gitee 绑定邮箱)

4)最后去 PR 评论:/check-cla。提示成功即可。


2.     很多用户存在提交 PR 后不管的现象,需要强调提交后持续关注 PR 的评论情况,及时修改尽早合入。修改之后,自己评论:/retest,重新发起自动检测。


3.     PR 格式问题,需要关联相关 issue。


4.     提交到同一路径,如果是图类,尽量保证原图大小,不要过大或过小。

5.     全文字体统一,代码注释使用英文,以及若干 markdown 规范问题。

6.     不能使用翻译工具直接翻译,不要逐字翻译,这样出来的效果很中式。应该按照自己的理解翻译,且译文应该符合英文阅读习惯。

7.     用词规范:1)专有名词保持书写正确,例如:AlexNet,不要写成 alexnet 或者 Alexnet。

                       2)用词符合业界习惯,例如:reasoning 和 inference 都有推理的意思,但是通常业界使用 inference。

8.     语法规范:1)标点符号使用正确,不要中英文标点混用。

                       2)主谓宾结构完整,不产生歧义。

9.     标题规范:1)标题首字母大写。

                       2)标题若动词开头,应采用动名词形式,即 doing 形式。

                       3)标题应尽量简短干练。


待补充。。。。。。


ps:实际操作试手看这里 MindSpore 已在 Gitee 和 GitHub 上开源,所有人都可参与~

作为社区贡献的主要途径之一,Gitee 上提交 PR 还是有很多小伙伴不熟悉的,通过前两次活动我们也发现了这一问题,为此写了这篇注意事项,希望给大家作参考,同时期待大家的补充与指正!

Gitee:https://gitee.com/mindspore

GitHub:https://github.com/mindspore-ai


写在最前面,参与贡献必须先签署 CLA,具体方法请参考下方的“规范”

流程:

提交 issue

进入 MindSpore 相应的仓,这里我们以主仓 mindspore 为例。

进入主仓https://gitee.com/mindspore/mindspore(注意是进入主仓,不是自己 fork 下来的仓)

在下图位置点击”+issue"



填写 issue 详细描述和标题,点击创建。(issue 描述建议以英文为主)

issue 需要填写负责人,参考活动帖的“注意事项”,每次活动会发布负责人。


提交 PR

提交流程不熟悉的,可以参考这两篇文章。

《git + gitee 入门实践》

(包含 git 安装,简单使用,代码托管等内容)

git+码云提交PR流程记录

(本地新建代码仓、拉取远程代码仓内容、提交到远程仓库,提交 PR 等内容)

git 解冲突流程

(发生冲突时看这里!)

PR 需要填写审核人,参考活动帖的“注意事项”,每次活动会发布审核人。


规范:

主要参考《贡献文档》,以下几点为现有问题总结:


1.     CLA 签署问题,新人需签署 CLA。(基本前提,很重要!

签署方法:

1)在自己的 PR 下评论:/check-cla,短暂等待后,自动回复弹出,点击“here”(如下图)。或者直接访问:https://clasign.osinfra.cn/sign/Z2l0ZWUlMkZtaW5kc3BvcmU=



2)根据身份选择签署,外部用户一般签署第三个“个人 CLA”



3)填写带“*”号的内容并打勾,签署成功。(没绑定邮箱的需要去 gitee 绑定邮箱)

4)最后去 PR 评论:/check-cla。提示成功即可。


2.     很多用户存在提交 PR 后不管的现象,需要强调提交后持续关注 PR 的评论情况,及时修改尽早合入。修改之后,自己评论:/retest,重新发起自动检测。


3.     PR 格式问题,需要关联相关 issue。



4.     提交到同一路径,如果是图类,尽量保证原图大小,不要过大或过小。

5.     全文字体统一,代码注释使用英文,以及若干 markdown 规范问题。

6.     不能使用翻译工具直接翻译,不要逐字翻译,这样出来的效果很中式。应该按照自己的理解翻译,且译文应该符合英文阅读习惯。

7.     用词规范:1)专有名词保持书写正确,例如:AlexNet,不要写成 alexnet 或者 Alexnet。

                       2)用词符合业界习惯,例如:reasoning 和 inference 都有推理的意思,但是通常业界使用 inference。

8.     语法规范:1)标点符号使用正确,不要中英文标点混用。

                       2)主谓宾结构完整,不产生歧义。

9.     标题规范:1)标题首字母大写。

                       2)标题若动词开头,应采用动名词形式,即 doing 形式。

                       3)标题应尽量简短干练。


待补充。。。。。。

练手看这里https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=159121,还能拿点福利,有疑问评论哦,我会回复的

用户头像

Geek_6cdeb6

关注

还未添加个人签名 2021.06.08 加入

还未添加个人简介

评论

发布
暂无评论
gitee上提交PR和issue流程和注意事项