Rails Trac 中的关键字有两种用法。第一种是一种标准标记系统,用户在其中使用他们认为可以描述工单主题的任何关键字来标记工单。为了让您了解人们使用这种类型标记的方式,以下是 25 个最常用的标记
postgresql、performance、ajax、test、routes、sqlserver、activerecord、mysql、rake、documentation、form、prototype、generator、fixtures、error、helper、migration、patch、scaffold、webrick、oracle、adapter、session、has_many、tested、inflector、date。
将关键字用作标记是可以的,但并不是必须的。如果某人遇到类似问题,这可能使他们更容易找到您的工单,但如果您不使用任何标记,那也不是什么大问题。
关键字的第二种用法是帮助管理工单的处理方式。截至撰写本文时,Rails Trac 中有 20 个标准报告,其中九个根据特定关键字筛选工单。部分报告仅在向发布推进期间使用。其中一个用于管理文档更新。而六个与补丁的生命周期和分类有关。这六个报告与我们这里讨论的内容有关。
补丁只是一个工单,其中附带 .diff 文件,其中包含某种错误修复或增强功能。补丁工单的摘要行应始终以文本 [PATCH] 开头。您无需使用 patch 关键字,它多余,而且没人关注它。在常规(非推进)开发期间,只有五个关键字用于管理补丁
verified、unverified、needy、risky、tiny
以下是如何在补丁中使用这些关键字:不要 使用它们。在创建补丁工单时,您不应该使用任何这些关键字。核心团队使用它们来表示补丁的处理状态,如果您自己添加关键字,则可能会混淆问题,并且可能使某人更难理清补丁的处理方式。
我相信您会很好奇(否则您不会阅读本文),以下是关键字的用途摘要。Verified 和 unverified 指示核心团队(或指定的助手)中的某人是否已签出补丁以查看其是否按预期工作、测试是否已通过等。Needy、risky 和 tiny 指示补丁对稳定性的潜在影响,以及使补丁工作是否可能需要额外的工作。可在 Trac 中的报告页面中找到完整说明。如果您真的想知道,请查看报告 3、4、11、12、16 和 17。
核心团队没有使用明确的流程来处理补丁提交。补丁生命周期报告有时会使用,有时人们只关注 Trac RSS 提要以获取新的补丁。Marcel Molina Jr 说,“我使用这些报告,但不是宗教般的使用。我偶尔使用它们。不过,当我这么做的时候,这会让我满意,并允许我快速处理许多工单。”因此,如果您希望快速处理您的补丁,最好去掉这五个补丁状态关键词,并允许核心团队毫无混乱地使用它们。