校对完毕

校对完毕

translated/talk/20160718 Tips for managing your project's issue tracker.md

@@ -1,19 +1,21 @@
-几个小窍门帮你管理项目的问题追踪器
+管理项目问题追踪器的几个小窍门
 ==============================================
 
 ![](https://opensource.com/sites/default/files/styles/image-full-size/public/images/business/BUSINESS_opennature_3.png?itok=30fRGfpv)
+***图片来源:***  opensource.com
 
-对于大多数开源项目来讲，问题追踪系统是至关重要的。虽然市面上有非常多的开源工具提供了这样的功能，但是大量项目还是选择了GitHub自带的问题追踪器（Issue Tracker）。
+对于大多数开源项目来讲，问题追踪系统是至关重要的。虽然有非常多的开源工具提供了这样的功能，大量项目还是选择了 GitHub 自带的问题追踪器（Issue Tracker）。
 
 它结构简单，因此其他人可以非常轻松地参与进来，但这才刚刚开始。
 
-如果没有适当的处理，你的代码仓库会挤满重复的问题单、模糊不明的特性需求单、混淆不清的bug报告单。项目维护者会被大量的组织内协调工作压得喘不过气来，新的贡献者也搞不清楚项目当前的重点工作是什么。
+如果没有适当的处理，你的储存库（repository）会变得很庞大，挤满重复的问题单、模糊不明的特性需求单、含混的 bug 报告单。项目维护者会被大量工作压得喘不过气来，新的贡献者也搞不清楚项目当前的工作重点是什么。
 
 接下来，我们一起研究下，如何玩转 GitHub 的问题单。
 
 ### 问题单就是用户的故事
 
-我的团队曾经和开源专家[Jono Bacon][1]做过一次对话，他是[The Art of Community][2]的作者、GitHub的战略顾问和前社区总监。他告诉我们，高质量的问题单是项目成功的关键。尽管有些人把问题单仅仅看作是一堆难题的列表，但是他认为这个难题列表是我们必须要时刻关注、完善管理并进行分类的。他还认为，给问题单打上标签的做法，会令人意想不到的提升我们对代码和社区的了解程度，也让我们更清楚问题的关键点在哪里。
+我的团队曾经和开源专家 [Jono Bacon][1] 做过一次对话，他是 [The Art of Community][2] 的作者、GitHub 的战略顾问和前社区总监。他告诉我们，高质量的问题单是项目成功的关键。有些人把问题单仅仅看作是一堆你不得不去处理的问题列表，但是如果这些问题单管理完善，进行了分类并打上标签，会令人意想不到的提升我们对代码和社区的了解程度，也让我们更清楚问题的关键点在哪里。
+
 
 “在提交问题单时，用户不太会有耐心或者有兴趣把问题的细节描述清楚。在这种情况下，你应当努力花最短的时间，尽量多的获取有用的信息。”，Jono Bacon 说。
 
@@ -21,66 +23,68 @@
 
 实际操作起来，大概是这样的：
 
->我是一名顾客，我想付钱，所以我想创建个账户。
+>我是一名**顾客**，我想**购买东西**，所以我想**创建个账户**。
 
-我们建议，问题单的标题始终使用这样的用户故事形式。你可以设置[问题单模板][3]来保证这点。
+我们建议，问题单的标题始终使用这样的用户故事形式。你可以设置[问题单模板][3]来保证一致性。
 
 ![](https://opensource.com/sites/default/files/resize/issuetemplate-new-520x293.png)
-> 问题单模板让特性需求单保持统一的形式
+          问题单模板让特性需求单保持统一的形式
+
+这个做法的核心点在于，问题单要清晰的呈现给它涉及的每一个人：它要尽量简单的指明受众（或者说用户），操作（或者说任务），和输出（或者说目标）。不过，不需要过分拘泥于这个模板，只要能把故事里的是什么事情或者是什么原因说清楚，就达到目的了。
 
-这个做法的核心点在于，问题单要被清晰的呈现给它涉及的每一个人：它要尽量简单的指明受众（或者说用户），操作（或者说任务），和收益（或者说目标）。你不需要拘泥于这个具体的模板，只要能把故事里的是什么事情或者是什么原因搞清楚，就达到目的了。
 
 ### 高质量的问题单
 
-问题单的质量是参差不齐的，这一点任何一个开源软件的贡献者或维护者都能证实。具有良好格式的问题单所应具备的素质在[The Agile Samurai][4]有过概述。
+问题单的质量是参差不齐的，这一点任何一个开源软件的贡献者或维护者都能证实。在[《The Agile Samurai》][4]中概述过一个良好的问题单所应具备的素质。
 
-问题单需要满足如下条件：
+好的问题单尽量满足如下条件：
 
 - 客户价值所在
 - 避免使用术语或晦涩的文字，就算不是专家也能看懂
-- 可以切分，也就是说我们可以一小步一小步的对最终价值进行交付
-- 尽量跟其他问题单没有瓜葛，这会降低我们在问题范围上的灵活性
+- 可以切分，也就是说我们可以逐步解决问题
+- 尽量跟其他问题单没有瓜葛，依赖其它问题会降低处理的灵活性
 - 可以协商，也就说我们有好几种办法达到目标
 - 问题足够小，可以非常容易的评估出所需时间和资源
 - 可衡量，我们可以对结果进行测试
 
-### 那其他的呢? 要有约束
+### 不满足的问题单呢? 要有约束
 
-如果一个问题单很难衡量，或者很难在短时间内完成，你也一样有办法搞定它。有些人把这种办法叫做”约束“。
+如果一个问题单很难衡量，或者很难在短时间内完成，你也一样有办法搞定它。有些人把这种办法叫做“约束”（constraints）。
 
-例如，”这个软件要快“，这种问题单是不符合我们的故事模板的，而且是没办法协商的。多快才是快呢？这种模糊的需求没有达到”好问题单“的标准，但是如果你把一些概念进一步定义一下，例如”每个页面都需要在0.5秒内加载完“，那我们就能更轻松的解决它了。我们可以把”约束“看作是成功的标尺，或者是里程碑。每个团队都应该定期的对”约束“进行测试。
+例如，“这个产品要快”，这种问题单不符合故事模板，而且是没办法协商的。多快才是快呢？这种模糊的需求没有达到“好问题单”的标准，但是如果你进一步定义一下，例如“每个页面都需要在0.5秒内加载完”，那我们就能更轻松地解决它了。我们可以把“约束”看作是成功的标尺，或者要实现的里程碑。每个团队都应该定期的对“约束”进行测试。
 
 ### 问题单里面有什么？
 
-敏捷方法中，用户的故事里通常要包含验收指标或者标准。如果是在GitHub里，建议大家使用markdown的清单来概述完成这个问题单需要完成的任务。优先级越高的问题单应当包含更多的细节。
+敏捷方法中，用户的故事里通常要包含验收指标或者标准。在 GitHub 里，建议大家使用 markdown 的清单来概括解决这个问题单需要完成的任务。优先级越高的问题单应当包含更多的细节。
 
-比如说，你打算提交一个问题单，关于网站的新版主页的。那这个问题单的子任务列表可能就是这样的：
+比如说，你打算提交一个关于新版网站主页的问题单。那这个问题单的子任务列表可能就是这样的：
 
 ![](https://opensource.com/sites/default/files/resize/markdownchecklist-520x255.png)
->使用markdown的清单把复杂问题拆分成多个部分
+         使用 markdown 的清单把复杂问题拆分成多个部分
 
-在必要的情况下，你还可以链接到其他问题单，那些问题单每个都是一个要完成的任务。（GitHub里做这个挺方便的）
+在必要的情况下，你还可以链接到其他问题单，以进一步明确任务。（GitHub 里做这个挺方便的）
 
-将特性进行细粒度的拆分，这样更轻松的跟踪整体的进度和测试，要能更高频的发布有价值的代码。
+将特性定义的越细化，越容易跟踪进度、测试，最终能更高效的发布有价值的代码。
 
-一旦以问题单的形式收到数据，我们还可以用API更深入的了解软件的健康度。
+以问题单的形式收到到问题所在后，还可以用 API 更深入的了解软件的健康度。
 
-”在统计问题单的类型和趋势时，GitHub的API可以发挥巨大作用“，Bacon告诉我们，”如果再做些数据挖掘工作，你就能发现代码里的问题点，谁是社区的活跃成员，或者其他有用的信息。“
+“在统计问题单的类型和趋势时，GitHub API 可以发挥巨大作用”，Bacon告诉我们，“如果再做些数据挖掘工作，你就能发现代码里的问题点，社区里的活跃成员，或者其他有用的信息。”
 
-有些问题单管理工具提供了API，通过API可以增加额外的信息，比如预估时间或者历史进度。
+有些问题单管理工具提供的 API 可以提高额外信息，比如预估时间或者历史进度。
 
 ### 让大伙都上车
 
-一旦你的团队决定使用某种问题单模板，你要想办法让所有人都按照模板来。代码仓库里的ReadMe.md其实也可以是项目的”How-to“文档。这个文档会描述清除这个项目是做什么的（最好是用可以搜索的语言），并且解释其他贡献者应当如何参与进来（比如提交需求单、bug报告、建议，或者直接贡献代码）
+团队决定使用某种问题单模板后，如何让所有人都照做？存储库里的 ReadMe.md 其实也可以是你们项目的 “How-to” 文档。这个文档应描述清楚这个项目是做什么的（最好是用可以搜索的语言），以及其他贡献者应当如何参与进来（比如提交需求单、bug 报告、建议，或者直接贡献代码）。
+
 
 ![](https://opensource.com/sites/default/files/resize/readme-520x184.png)
->为新来的合作者在ReadMe文件里增加清晰的说明
+         在 ReadMe 文件里增加清晰的说明，供新合作者参考
 
-ReadMe文件是提供”问题单指引“的完美场所。如果你希望特性需求单遵循”用户讲故事“的格式，那就把格式写在ReadMe里。如果你使用某种跟踪工具来管理待办事项，那就标记在ReadMe里，这样别人也能看到。
+ReadMe 文件是提供“问题单指引”的完美场所。如果希望特性需求单遵循“用户讲故事”的格式，那就把格式写在 ReadMe 里。如果使用某种跟踪工具来管理待办事项，那就标记在 ReadMe 里，这样别人也能看到。
 
-”问题单模板，合理的标签，如何提交问题单的文档，确保问题单被分类，所有的问题单都及时做出回复，这些对于开源项目都至关重要“，Bacon说。
+“问题单模板、合理的标签、提交问题单的指导文档、确保问题单被分类并及时回应，这些对于开源项目都至关重要”，Bacon 说。
 
-记住一点：这不是为了完成工作而做的工作。这时让其他人更轻松的发现、了解、融入你的社区而设立的规则。
+记住一点：这不是为了完成工作而做的工作。这是让其他人更轻松的发现、了解、融入你的社区而设立的规则。
 
 "关注社区的成长，不仅要关注参与开发者的的数量增长，也要关注那些在问题单上帮助我们的人，他们让问题单更加明确、保持更新，这是活跃沟通和高效解决问题的力量源泉"，Bacon 说。