diff --git "a/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" "b/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" index cd78bd8ea5ed122721f5914875904d8b945e17fa..552319a709ed688d42bf8e0ddad93e99077b8acd 100644 --- "a/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" +++ "b/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" @@ -142,8 +142,96 @@ Issue 的翻译大致为**议题**、**问题**。 +### Issue 的进阶使用 + +掌握了 Issue 的基础使用之后,作为一个优秀的开发者,我们还应该掌握一些进阶的知识,它能让你压榨干净 Issue 的每一分价值。 + +#### Issue 的详细设置 + +如果仓库是你自己的,你可以在每一个 Issue 的面板看到更多的进阶选项,如图所示: + +![Issue的进阶设置](https://images.gitee.com/uploads/images/2020/1104/121602_7f774b18_1277510.png "image-20201103110330425.png") + +* **负责人**:负责人指的是谁来负责处理这个 Issue,可以设置用户为负责人或协作者。对于个人版来说,只能选择自己。如果是组织或者企业,可以指派他人。同一个 Issue 仅能有一个负责人,但问题可能由多个人协作解决,可以添加多个协作者。其它权限是一样的。对于企业版用户来说,设置负责人可以很好地统计任务完成情况(个人版无此功能,因此负责人也可以不设置),如图所示: + + ![组织或企业的负责人选择](https://images.gitee.com/uploads/images/2020/1104/121656_f6ccd9c7_1277510.png "image-20201103154930390.png") + + 企业版中可根据负责人统计任务完成信息: + + ![企业版中可根据负责人统计任务完成信息](https://images.gitee.com/uploads/images/2020/1104/121732_dd5fd2c8_1277510.png "image-20201103155036529.png") + +* **标签**:高质量的 Issue 是项目成功的关键。有些人把 Issue 仅仅看作是一堆你不得不去处理的问题列表,但是如果这些问题单管理完善,进行了分类并打上标签,会令人意想不到的提升我们对代码和社区的了解程度,也让我们更清楚问题的关键点在哪里。[2]将标签完善之后,不管是仓库所有者还是其他人都可以快速定位含有某标签的 Issue,协作的效率也将大大提高。 + + 在 Gitee 中,Issue 中的**标签**支持修改原有标签名称、从其它项目导入标签以及新增自定义标签等。一个默认的仓库会有如下一些默认的标签[2][3]: + + ![Issue中的默认标签](https://images.gitee.com/uploads/images/2020/1104/121827_6dd23a40_1277510.png "image-20201103210736651.png") + + 如果默认的标签不够你使用,你可以添加你的自定义标签。只需要点击右上角的`+`号即可。 + +* **项目**:项目仅企业版用户可以关联,个人版或组织在这一项可以忽略掉。企业版用户可以根据下面的图片来了解如何创建一个项目,以及如何找到新创建的项目。当项目创建之后,就可以关联到某个 Issue 了。 + + 先进入企业面板,进入所在企业: + + ![先进入企业面板,进入所在企业](https://images.gitee.com/uploads/images/2020/1104/121905_7de2c1b7_1277510.png "image-20201103211346712.png") + + 右上角新建项目可以新建: + + ![右上角新建项目可以新建](https://images.gitee.com/uploads/images/2020/1104/121940_60a50a92_1277510.png "image-20201103211512199.png") + + 查看新建的项目: + + ![查看新建的项目](https://images.gitee.com/uploads/images/2020/1104/122018_2ef66098_1277510.png "image-20201103211600514.png") + +* **里程碑**:里程碑是某功能或某个时间段的一堆问题的集合,比如我们要写一本书,一个章节为一个里程碑,而这个章节里面的每一个小节我们就可以分别提多个 Issue,最后将这些 Issue 关联到这个章节的里程碑中,方便管理,可以很容易看到整个章节的完成进度。我们可以根据自己的需要,来使用里程碑的功能。下面是一些使用里程碑功能的例子[1]: + + - **发布测试**——在你发布项目的 Beta 版之前,包含你需要修复的 bug 文件相关的 Issue。这样可以确保你不会漏掉什么。 + - **十月冲刺**——记录你再十月份应该做的问题清单。相当于一个工作清单,时刻提醒你应该重点完成哪些工作。(当然,你设定一个九月要做的事情的清单也是可以的) + - **重新设计**——记录与重新设计项目的问题清单。这是一种收集灵感的好方法。 + + > 如何创建自己的里程碑?(所有用户均可创建) + + 新建里程碑: + + ![新建里程碑](https://images.gitee.com/uploads/images/2020/1104/122051_3d9f8f40_1277510.png "image-20201104104505287.png") + + 新建完成后即可在Issue中关联: + + ![新建完成后即可在Issue中关联](https://images.gitee.com/uploads/images/2020/1104/122123_f025a6a2_1277510.png "image-20201104104609496.png") + +* **关联分支**:这里可以选择关联到该仓库的哪个分支。 + + ![选择关联分支](https://images.gitee.com/uploads/images/2020/1104/122205_fa7de81b_1277510.png "image-20201104115955351.png") + +* **计划开始日期**:该 Issue 计划开始处理的日期。 + +* **计划截止日期**:该 Issue 计划截止处理的日期。 + +* **置顶选项**:该 Issue 在 Issue 列表中的置顶级别。 + + ![置顶选项](https://images.gitee.com/uploads/images/2020/1104/122231_61ed06f5_1277510.png "image-20201104120147079.png") + +* **优先级**:该问题的严重程度,优先处理级别。 + + ![优先级](https://images.gitee.com/uploads/images/2020/1104/122301_aeea5b92_1277510.png "image-20201104120303417.png") + +#### Issue 的状态和看板 + +Issue 在提出之后,对于个人版来说可以有四种状态:待办的、进行中、已完成、已拒绝。负责人或者协作者可以修改该状态。企业版会可选更多的状态。 + +> 状态变更之后,允许再次变更,比如设置为`已完成`状态的 Issue,可以再次修改为`进行中`。 + +![Issue的状态切换](https://images.gitee.com/uploads/images/2020/1104/122341_7c087174_1277510.png "image-20201104120709716.png") + +我们还可以在`看板`中看到处于每种状态的 Issue 的列表。 + +![看板页面](https://images.gitee.com/uploads/images/2020/1104/122400_f9648c84_1277510.png "image-20201104120934433.png") + + + ### 参考资料 [1] [https://guides.github.com/features/issues/](https://guides.github.com/features/issues/) -[2] [https://zhuanlan.zhihu.com/p/75691927](https://zhuanlan.zhihu.com/p/75691927) \ No newline at end of file +[2] [https://zhuanlan.zhihu.com/p/75691927](https://zhuanlan.zhihu.com/p/75691927) + +[3] [https://blog.csdn.net/lovewinner/article/details/80763629](https://blog.csdn.net/lovewinner/article/details/80763629) \ No newline at end of file