如何使用 Issue 管理软件项目？

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

本文介绍 Issue 的基本用法。

一、Issue 是什么？

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

一个软件的 bug

一项功能建议

一项待完成的任务

文档缺失的报告

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

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

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

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

二、Issue 跟踪管理系统

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

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

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

项目管理

　　- 指定 Issue 的优先级

　　- 指定 Issue 所在的阶段

　　- 分配负责 Issue 的处理人员

　　- 制定日程

　　- 监控进度，提供统计

团队合作

　　- 讨论

　　- 邮件通知

代码管理

　　- 将 Issue 关联源码

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

三、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

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