GitHub 上讨论议题 - 建立第一个 Issue 与自订 Labels

GitHub Issue 有点像是专案管理系统内管理工作事项的功能，但它能达到功能更多：无论是个人或公开专案，你都可以透过建立 issue 来表达自己的想法，如 回报 Bug、强化既有功能、建立工作事项与讨论专案规划。 每一份 issue 皆公开且有完整纪录，能整合程序码并且配合後续 CI/CD 功能确定问题是否解决。issue 可以搭配 通知(Notifications) 功能，让与会者随时了解此 issue 处理情况。

在此篇文章，我们将简单介绍如何建立 Issue 与自订 Labels

建立 Issue

开启上一篇文章所建立的 Repo > 点选上方 issue 功能 > 点选右边 New Issue 按钮

输入 title 与 comment (comment 支援 markdown 语法且拥有预览功能)，并在右边 Assignees 区域点选 assign yourself，将工作指派给自己

Issue 中也提供 Labels 功能，方便我们进行整理与确认每个 Issue 的优先权。预设已经内建 9 种 Labels，理所当然，你也可以依据需求自订 Labels。以下图为例，内建的 Labels 包含：bug (问题)、documentation (文件), duplicate (重复问题), enhancement (新功能或请求), good first issue, help wanted(需要额外关注), invalid(不正确), question(问题), wontfix(不会进行)。

我们将此 issue 定义为 enhancement，完成後点选 Submit new issue

建立好 issue，可以看见整个 issue 发展的历史纪录，包含：

1. 指派给自己
2. 加上 enhancement label
3. 加上 comments

这个 issue 可能经过轰轰烈烈的讨论或辛苦的修正後，在获得解决後想要关闭此 issue，你可以将画面拉到最底端，选择 Close issue 即可。

另外，你可能也发现有另外三个功能可以连结 issue，分别是 Project, Milestone 与 Linked pull request。前两者与专案管理有关，你能将 issue 与专案或自己定义的 milestone 建立连结，方便进行追踪；後者与 repo 内容有关，可以与发出的 pull request 进行连结，当检视程序码(或内容)历史纪录时，可以了解与哪个 issue 有关。

若你有使用过其他较完整功能的 CI/CD 工具 (如 Azure DevOps 与 Gitlab)，应该会觉得相当熟悉...
GitHub 本身即是一个完整 DevOps Tools

自订 Labels

若你发现内建的 Labels 并没有自己想要的情境，你也可以自己定义一个。在 issue 画面中，点选 Labels 按钮

在 Labels 管理画面，点选右边 New Label

输入名称、描述与色码(有随机按钮可以点)，点选 Create Label，即完成自订 Labels。

看完整篇文章，你应该已经了解如何管理 Issue 与自订 Labels，更重要的是了解 issue 可以与其他功能进行连结，方便所有与会人员随时进行检视，完整掌握 Repos 发展的来龙去脉。 Repo Owner 能透过 issue label 功能进行管理，确认专案发展皆在控制之中。在下一篇文章，我们将继续介绍 较进阶的Milestone、Tag 与 Release 功能。

若喜欢我的文章，欢迎追踪与分享，谢谢。