你真的会用 Issue 吗?

大家对 Issue 一定不陌生,它灵活又实用,可以用来做 Bug 跟踪、需求管理、项目管理、交流探讨、写文章……

不少新用户在后台问我们,如何优雅地使用 Issue ?

阮一峰老师近期写了一篇很棒的文章,详细介绍了 Issue 的基本概念和用法,还有 Github 和 码云( Gitee.com )的使用场景哦!超实用!小伙伴们快快学起来吧!

Issue 用得好,下班回家早 —— Gitee 君

本文系阮一峰老师发表在其个人网络日志中的作品,已获得转载授权,原文地址请点击文末左下方“阅读原文”。

软件开发(尤其是商业软件)离不开项目管理,Issue 是最通用的管理工具之一。

本文介绍 Issue 的基本用法。

1. Issue 是什么?

Issue 指的是一项待完成的工作,通常与系统的改进相关,中文可以译为"问题"或"事务"。下面这些都是 Issue 的例子。

一个软件的 bug。

一项功能建议。

一项待完成的任务。

文档缺失的报告。

每个 Issue 应该包含该问题的所有信息和历史,使得后来的人只看这个 Issue,就能了解问题的所有方面和过程。

历史上,Issue 起源于客服部门。用户打电话反映问题,客服就创建一个工单(ticket),后续的每一个处理步骤、每一次与用户的交流,都要更新工单,记录全部信息。这就是 Issue 的前身。

因此,Issue 的原始功能是问题追踪和工单管理,后来不断扩展,逐渐演变成全功能的项目管理工具,还可以用于制定和实施软件的开发计划。

除了软件,其他项目也可以使用 Issue,比如有人把自己住宅的改善计划都做成了 Issue。

2. Issue 跟踪管理系统

专门管理 Issue 的软件,叫做Issue 跟踪管理系统(Issue tracking system)。它面向所有人,普通用户也可以使用。

还有一种Bug 跟踪管理系统,通常只面向开发者,比如下图的 Bugzilla。它和 Issue 系统可以同时使用,但是也可以被 Issue 系统取代。

一般来说,Issue 跟踪管理系统应该具有以下功能。

  • 项目管理

- 指定 Issue 的优先级

- 指定 Issue 所在的阶段

- 分配负责 Issue 的处理人员

- 制定日程

- 监控进度,提供统计

  • 团队合作

- 讨论

- 邮件通知

  • 代码管理

- 将 Issue 关联源码

- 将 Issue 关联代码提交与合并

3. Github Issues

目前,最出名的 Issue 跟踪管理系统是JIRA。它是一个收费软件,这里就不介绍了。下面通过免费的Github Issues,来介绍如何使用 Issue。

3.1 基本用法

每个 Github 代码仓库都有一个 Issues 面板。

进入该面板,点击"New Issue"按钮,就可以新建 Issue。

上图是新建 Issue 的界面,左侧填入 Issue 的标题和内容,右侧是四个配置项(只有项目管理者才能看到)。

Assignees:人员

Labels:标签

Projects:项目

Milestone:里程碑

3.2 Assignee

Assignee 选择框用于从当前仓库的所有成员之中,指派某个 Issue 的处理人员。

下拉框里面单击人名即可。

3.3 Labels

Issue 可以贴上标签,这样有利于分类管理和过滤查看。

新建标签,要在 Issues 面板的首页,点击 Labels 按钮。

这时,会显示六个默认的标签。

如果想新建更多的标签,可以点击 New label 按钮。然后,填写标签名,选择标签颜色。

3.4 常用 Label

对于大型项目, 每个 Issue 至少应该有两个 Label ,一个表示性质,另一个表示优先级。

表示性质的 Label,可以参考这篇文章的范例。

表示优先级的 Label,可以采用下面的级别。

高优先级(High):对系统有重大影响,只有解决它之后,才能去完成其他任务。

普通优先级(Medium):对系统的某个部分有影响,用户的一部分操作会达不到预期效果。

低优先级(Low):对系统的某个部分有影响,用户几乎感知不到。

微不足道(Trivial):对系统的功能没有影响,通常是视觉效果不理想,比如字体和颜色不满意。

3.5 Milestone

Milestone 叫做"里程碑",用作 Issue 的容器,相关 Issue 可以放在一个 Milestone 里面。常见的例子是不同的版本(version)和迭代(sprint),都可以做成 Milestone。

新建 Milestone,要在 Issues 面板的首页,点击 Milestones 按钮。

这时,再接着点击 New milestone 按钮,然后填写 Milestone 的名称和内容,还可以指定到期时间。

3.6 全局视图

Issues 面板只能查看和操作当前仓库,Github 还提供全局视图,让用户查看和操作所有与自己相关的 Issue。

访问github.com/issues这个网址,就可以打开全局视图。里面的 Issue 分成三类。

Created:你创建的 Issue

Assigned:分配给你的 Issue

Mentioned:提及你的 Issue

Created 和 Assigned 的含义显而易见,Mentioned 是指他人在 Issue 里面 @ 了你。下面是一个例子。

It looks like the new widget form is broken on Safari. When I try and create the widget, Safari crashes. This is reproducible on 10.8, but not 10.9. Maybe a browser bug?

/cc @kneath @jresig

全局视图还提供了搜索、过滤和排序功能。

4. 看板功能

4.1 看板是什么?

看板(kanban)是敏捷开发的重要手段,主要用于项目的进度管理。所有需要完成的任务,都做成卡片,贴在一块白板上面,这就是看板。

按照不同的阶段,看板分成若干列。上图是一种常见的分法,将项目周期分成三列。

Todo (待开发)

Doing (开发中)

Done (已完成)

你可以根据实际情况,分出更多的列。

Todo (待安排)

Plan (计划)

Develop (开发)

Test (测试)

Deploy (部署)

Done (已完成)

4.2 Github 的看板功能

Github 提供 Issue 看板。首先,在仓库首页进入 Projects 面板。

然后,点击 New Project 按钮,新建一个 Project,比如"2.0 版"。

接着,点击 Add column 按钮,为该项目新建若干列。

最后,将 Issue 分配到对应的列,就新建成功了一个看板视图。

Issue 可以从一列拖到另一列,表示从一个阶段进入另一个阶段。

许多第三方工具可以增强 Github 的看板功能,最著名的是Zenhub,这里就不详细介绍了。

5. 码云(Gitee.com)的 Issue 系统

除了 Github 以外,Gitlab也提供免费的 Issues 管理系统,而且 比前者更易用。但是,我不打算介绍它,而是想介绍开源中国社区推出的代码托管服务码云。

码云是 Gitlab 的深度定制,提供汉语界面,符合国人的使用习惯,并且访问速度极快,我感觉比 Gitlab 快了一个数量级。另一方面,开源中国的红薯老大一直支持我,我也想借这个机会,推广一下他们的产品,让更多的人知道这个优秀的国产 SaaS 服务。

5.1 新建 Issue

码云的每个仓库都有一个Issues 面板。进入后,点击新建 Issue,就可以创建 Issue 了,里面的设置项比 Github 丰富好多。(注意,只有仓库的管理员才能看到设置项。)

其中的"负责人"(Assignee)、"标签"(Label)、"里程碑"(Milestone)与 Github 完全一致。"关联分支"指定 Issue 归属于哪一个分支,"开始时间"和"结束时间"指定处理日程。"置顶选项"指定哪些 Issue 出现在最前面,而且还分成高中低三档。

由于设置多,所以 Issue 列表提供的过滤开关也多。

5.2 看板功能

码云的看板功能比 Github 更友好,直接提供四个现成的看板。

待处理

进行中

已完成

已验收

所有 Issue 的初始状态都是"待处理",用户可以手动把它们拖到其他列。

5.3 企业版

码云跟 Gitlab 一样,也提供企业版。里面的"任务"模块有一个强大的 Issue 全局视图,分成四种浏览模式。

指派给我的

我发布的

我参与的

全部任务

这是默认的列表视图,可以点击右上角,切换成全局的"看板视图"。

这个界面还可以直接新建任务,而不用进入仓库主页。新建任务时,允许指定"关联项目"、"负责人"和"预计工时"。

新建任务以后,还可以对任务进行再次编辑,这时可以设置"优先级"、"关联项目"和"子项目"等。

我就介绍到这里了,接下来你可以点击进入Demo,体验一下上面介绍的各项功能。

(完)

那么问题来了,平时你是怎么用 Issue 的呢?看了这篇,有什么新的 idea 吗?

原文发布于微信公众号 - 码云Gitee(mayunOSC)

原文发表时间:2017-09-04

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏算法+

pytorch 移动端框架 thnets 附c示例代码

前年年前做一个手机移动端图像识别项目的时候, 先后尝试了mxnet,thnets,caffe,tensorflow. 当时的情况是,mxnet内存管理奇差,内存...

4867
来自专栏CSDN技术头条

NNabla:索尼开源的一款神经网络框架

NNabla是一款用于研究、开发和生产的深度学习框架。NNabla的目标是要能在台式电脑、HPC集群、嵌入式设备和生产服务器上都能运行。 安装 安装NNabla...

2236
来自专栏应用案例

RIOT 与 ImageOptim - 两款 Win 和 Mac 上好用的免费图片优化无损压缩工具

不管你是网站站长、自媒体、博客作者、摄影师、设计师,还是需要在网上分享传输图片/照片的人,都希望自己上传图片耗时更短、图片体积更小,别人浏览时又能更快下载显示出...

4195
来自专栏FreeBuf

使用Python和Tesseract来识别图形验证码

各位在企业中做Web漏洞扫描或者渗透测试的朋友,可能会经常遇到需要对图形验证码进行程序识别的需求。很多时候验证码明明很简单(对于非互联网企业,或者企业内网中的应...

7035
来自专栏数据小魔方

细分饼图

今天跟大家分享的是一种叫做细分饼图的图表制作技巧! 它所用到的技巧很简单,表达的数据也不很复杂,就是三层数据结构,每一层都是上一层的细分数据。 首先我们还是来看...

3585
来自专栏量子位

神经网络模型的可执行软件包,可以压缩到多小?

昨天,有一个Facebook研究人员Nadav Rotem在Reddit上放出了极简版的教程Compile neural networks into small...

1294
来自专栏吉浦迅科技

如何在Jetson TK1上安装Caffe深度学习库

        Caffe的创造者 Yangqing Jia,最近花了些时间在NVIDIA Jetson 开发板上运行caffe框架。Jetson TK1 有1...

3617
来自专栏编程

基于Python的人脸识别库,离线识别率高达99.38%!

-欢迎 原文该项目是要构建一款免费、开源、实时、离线的网络 app,支持组织者使用人脸识别技术或二维码识别所有受邀人员。有了世界上最简单的人脸识别库,使用 Py...

2918
来自专栏PHP实战技术

手把手教你玩转12306验证码的秘密!

12306相信对很多小伙伴都不陌生,假如问你对这个网站的印象的时候,你不是会立即想起那个坑爹的验证码,而正是这个验证码,也一时间成为小伙伴们讨论的话题,今天思梦...

2768
来自专栏小詹同学

知乎大神爬取高颜值美女(Python爬虫+人脸检测+颜值检测)

这是一篇来自知乎大神的技术文章 ---- 写在前面: 本文作者:邓卓 原文链接:本文转发修改已取得原作者授权 https://zhuanlan.zhihu.c...

8467

扫码关注云+社区

领取腾讯云代金券