Pull-Request

龙蜥社区近期上线了【人人都能够参加开源】流动，流动里波及了一项重要的事项就是：提！交！PR！本文就跟大家分享一下作为入门级的开发者，能够通过哪些形式参加社区建设？以及在社区参加过程当中如何提交 Pull Request（以下简称“PR”） ？本文整顿自龙蜥大讲堂第 23 期，视频回放已上线至龙蜥官网，欢送查看（链接见文末）！ 一、提交 PR 次要流程代码库存放于 Gitee 平台上，以本次流动为例，支付的工作详情（即 Issue），以及最终提交的工作成绩，都会在这个平台上进行。那么，如何在 Gitee 上提交一个 PR呢？ 1、 Fork（复刻）一个代码仓库。在本次流动工作的 Issue 页上，曾经写明了指标仓库。你只须要返回 Fork 指标仓库。 2、 Clone（克隆）本人的仓库到本地。 3、 建设一个分支，在分支中批改内容，而后提交 PR。 4、 编写 comments，也就是你做了哪些变更，而后期待仓库管理员的审核。 5、 如有须要，能够与管理员（个别是 SIG maintainer）进行交换，可能会须要改良本人的 PR。 6、 管理员合入你的代码后，关注本人的代码是否有改变，并踊跃加入评审。 （图/提交PR流程） 二、初学者容易出错的中央须要留神的是，初学者常常在 Git 命令上出错。常见的起因个别是：本来应该放在不同分支上批改的内容，却被放到了雷同的分支上批改，相当于重叠了，这样将会与同时提交的小伙伴产生抵触。 （图/出错示例图） 上图可看出，1000 人依照不同分支同时开发没问题，那么问题常常会出在哪？就是在合并入的时候容易出错。如果想把 1000 个分支合并回来，并且不出错，在这个过程当中可能就会有一些细节问题。 怎么解决这些问题？须要初学者依据一些既定的流程来进行操作。这些既定的流程本文会写出一部分，另外一部分和公司的具体开发流程相干。 三、手把手演示如何提交PR解决如上问题，首先就是要新建分支，接下来用具体例子来具体解释。 以 Express DPU 我的项目为例（是高性能的 DPU 库）。当你拿到这个我的项目的时候，首先想到的是这个我的项目我能做点什么？比如说（本文演示须要）小龙看到 Readme-cn.md 文件中有个题目是英文的，是不是能够变成中文的呢？ 接下来，就依照步骤批改这个英文题目。 第一步：须要先 Fork 一下感兴趣的代码仓库。 点击 Fork 后抉择集体。 Fork 的含意是什么？就是对代码进行批改的时候，不会影响上游的代码，这样的话避免一些误操作，并且也能够在你的代码中衍生出本人格调的代码。 第二步：将 Fork 好的代码仓库 Clone 到仓库本地。 ...

Forked Repo一般地，本地 forked repo 有两个远端：upstream 指向原作者的 repoorigin 指向 forked repo更新方法# 切换到 master 分支git checkout master# 拉取原作者的 repogit pull upstream master:master# 更新 forked repogit push origin master:master# 更新 forked repo 的远端分支git remote update –prunePull Request 追踪特性pull request 会追踪发起它的远端分支（简称 PR 分支，本地副本被称为“本地PR 分支”），除非已被 merge 或者处于 close 状态。如果 pull request 被 merge，PR 分支可以被原作者删除。如果 pull request 被 close，PR 分支可以被原作者删除。一旦删除，该 pull request 就不能再被 reopen。预览 Pull Request 合并后的状态首先，更新 repo。其次，搭建预览现场。此时完全不用担心 conflict（除非 GitHub 网页已经指出）。git checkout -b [预览分支]git pull [发起 repo 的 URL] [发起分支]然后，预览（一般是测试）。最后，清理预览现场。git checkout mastergit branch -D [预览分支]解决 Pull Request 冲突GitHub 的 pull request 页面指出 PR 冲突，可用下列方法解决：首先，更新 repo。然后，将 master 分支合并到本地 PR 分支。此时必然发生 conflict，解决并新建 commit。建议使用 GitHub Desktop 或 IDE 来执行该步骤。最后，push 本地 PR 发起分支。此时，GitHub 上的 pull request 会追加 commit，并指出冲突已消除。Pull Request 与 IssueGitHub 中 pull request 和 issue 共用一套编号。可在页面末尾添加的 comment，称为 issue comment。相关的 API 都在这里。如果 commit message 包含fix / fixes / fixed / close / closes / closed / resolve / resolves / resolved等关键字加上#编号，一旦 commit 被加入 repo，相应的 issue 就会被 close。 ...

github contributions一般而言，任何一个人的github主页都有一个这样的方格图；每一个小格代表了one day，不同的颜色深度，代表了不同的contributions次数，那么这个次数是怎么计算的呢？本文的翻译就是上图底部的蓝色链接中的Learn how we count contributions.译文正文为什么我的contributions没有在个人profile中体现出来？个人profile中的contributions绘图是用于记录个人对github所做的contributions记录，贡献按照协调世界时（UTC）而不是您当地的时区加上时间戳。只有在满足特定标准的情况下才会当做contributions计算；在某些情况下，我们可能需要重建您的contributions绘图才能显示你的contributions。没有被记录的contributionsIssues和pull requests如果Issues和pull requests只有是在独立仓库中操作的，才会显示在您的contributions绘图上，而对于fork的仓库无法被记录的。Commits如果Commits符合以下所有条件，则会在您的contributions绘图上显示：用于Commits的电子邮件地址与您的GitHub帐户相关联Commits是在独立的仓库中进行的，而不是forkCommits在一下条件下完成在仓库的默认分支（通常是master）在gh-pages分支中（对于具有Project Pages站点的仓库）此外，必须至少满足下列条件之一：你是该仓库的协作者，或者是这个仓库所属组织的一员；你已经fork了该工程你对这个仓库提过Issues或者pull requests你star加星过这个仓库，通常的一些没有被记录的原因要显示在您的contributions绘图上，共同提交的提交必须符合与一个作者的提交相同的标准。当合并pull requests并且Commit时，只有合并pull requests的用户和打开pull requests的用户才会收到贡献积分。拉取请求的任何其他贡献者都不会获得贡献积分。当重新提交Commit时，Commit的原始作者和重新提交的人，无论是在命令行还是在GitHub上，都会收到贡献信用。Commit是在不到24小时前完成在完成符合要求的Commit后，您可能需要等待最多24小时才能看到贡献出现在您的贡献图表上。您尚未将本地Git提交电子邮件添加到您的个人资料中必须使用已添加到您的GitHub个人资料中的电子邮件地址进行提交，以便显示在您的贡献图表上。您可以通过将.patch添加到提交URL的末尾来检查用于提交的电子邮件地址，例如：https://github.com/octocat/octocat.github.io/commit/67c0afc1da354d8571f51b6f0af8f2794117fd10.patchFrom 67c0afc1da354d8571f51b6f0af8f2794117fd10 Mon Sep 17 00:00:00 2001From: The Octocat <octocat@nowhere.com>Date: Sun, 27 Apr 2014 15:36:39 +0530Subject: [PATCH] updated index for better welcome message可以配合：查看email：git config –global user.email 设置email：git config –global user.email XXXX@gmail.com未在默认master或gh-pages分支中进行提交只有在默认分支（通常为master）或gh-pages分支（对于具有Project Pages站点的存储库）中进行提交时才会计算提交。提交共同作者无权访问存储库如果在共同作者无权访问的存储库中进行了提交，则该提交将不计入共同作者的贡献。提交是在一个fork分支中进行的用fork做的提交不会计入你的贡献。要使它们计数，您必须执行以下操作之一：打开pull requests以将更改合并到父存储库中。要分离fork并将其转换为GitHub上的独立存储库，请联系GitHub支持或GitHub Premium支持。如果fork具有自己的分支，请让支持知道分支是否应随存储库移动到新网络中或保留在当前网络中。Commit是在合并和压缩的pull requests中完成的合并和压缩的pull requests中的Commit将不计入您的贡献。只有合并pull requests的用户和打开pull requests的用户才会收到贡献积分。拉取请求的任何其他贡献者都不会获得贡献积分。