以下的内容将基于一个项目来展开,主要内容是如何查看项目的状态以了解其进展。
项目地址https://github.com/twbs/bootstrap
github上的Bootstrap项目主页
下面的解释的术语在图中用红框标识出来了
watch:表示有7.2k人一直在关注着这个库
star:表示137k人将这个项目标上星号,表示这是他们最喜爱的项目之一
fork:表示有67.3k人曾经分叉过这一库文件,在github上制作自己的副本,并通过github上传对项目的修改以及与他人分享这些修改。
继续往下看,可以看到项目的一个简短描述
commits:表示该项目目前为止已经有19114次提交了
branches:表示目前正在开发(分支)的不同的历史数据流有50个
releases:表示目前已经有55个版本的软件推荐给人们使用(发布)
contributors:表示有1095人编写了代码的某些部分
续往下看,可以看到目前我们正在查看的是主分支,可以看到项目根目录文件夹下包含的文件夹以及文件
查看README.md文件
在项目根目录中有一个叫README.md的文件,可以通过在主页往下滑查看到它的内容,或者直接在目录中点击这个文件来查看内容。
通常这个文件里面包含的内容是对这个项目的介绍以及项目的一些说明,例如,如何安装软件,如何使用代码,如何运行任何自动化测试。
查看提交历史
点击主页的commit,就可以看到如下图所示的提交清单
单击任何一个提交将会向你展示提交信息。该信息解释了作出修改的原因。提交信息下面你会看到该提交的内容,包含每个文件的添加、删除和修改。其中删除的信息用红色表示,添加的信息用绿色表示(如下图所示)
查看拉请求
拉请求可使你了解当前正在进展中的工作。返回到主页面,单击Pull requests,你将会看到一个打开的拉请求列表,这些是人们正在使用的优秀功能或修复。
单击其中一个拉请求,你将会看到一个描述拉请求的简短标题以及人们做出的一些评论(如下图)。查看拉请求可了解人们正在做什么以及每个修改所处的当前状态,是修改缺陷还是功能建议
查看问题
返回到主页面,单击issue,默认情况下,将会看到一个包含了全部开放问题的列表(如下图)
单击一个问题,你将会看到该问题的标题以及与之有关的任何评论(如下图)
查看脉冲
脉冲是了解一个项目近期活动的分毫的方式。返回到主页面,单击insights,出现如下图
注意上图右上角可以定义脉冲周期为最后一天、三天、一周或一月。脉冲页首先显示的是pull requests预览,包括已经合并的拉请求数量和提出的拉请求数量,同时也显示了有多少问题是关闭的或者是最新提出的。
柱状图显示了在此期间作出最多提交的贡献者。
贡献者图表
单击上副图左侧的contributors,可以得出一个贡献者图表。它反映了基于提交、添加或删除数量得出的一段时间内的贡献者数量。下图中有一个显示所有贡献者的图,随后是一些小图,显示单个的开发者所作的贡献,并按从大到小的顺序显示。
默认情况下,图标的时间段是该项目的整个生命周期。如果你想选择一个较短的时间,只需在主图单击你想开始的时间点,然后拖拉到你希望新图形结束的时间点再释放。如下图所示:
提交图
提交图显示了在项目的整个生命周期内每周提交的数量,给出了一个非常粗略的活动的衡量及其随时间的变化,下图中的柱状图,每个条柱表示一周,可以通过单击某个特定的条柱得到具体的线状图
码频图
码频图显示了一段时间内从项目中添加和删除的行数,码频图特别有助于识别你的代码库中是否有大的变化。
网络图
网络图显示了分支数量以及贯穿整个项目历史分支上的提交数量,除此之外,还显示了贡献者创建的分叉数量。
网络图有助于查看一个分支到底进展有多远,或者查看某些人在自己分支内正在做哪种类型的工作。当这些提交通过一个拉请求撤回到原来存储库的主分支时,我们将看到图中有一个箭头和一个合并提交。我们可以将鼠标移到这些提交(每一个小圆点)上,查看是谁写的及提交的信息是什么。
成员列表
成员列表仅显示已对储存库分叉的人以及分叉的分叉。这些人不是原来父库的合作者,因此需要储存库的本地副本以便于通过拉请求对其做出贡献。
未完待续。。。。
参考书籍:《GitHub入门》 Peter Bell & Brent Beer