Documentation/BugTriageDay

OpenStack 文档

文档贡献者指南 — 新手指南 — 构建文档 — 专业团队 — 文档团队办公时间

日期：2014年12月17日，星期三

时间：只要你醒着！

沟通：#openstack-doc 在 Freenode IRC 网络上

目标：整理 openstack-manuals 和 openstack-api-site 中至少 30 个文档缺陷。

如何参与

1. 在活动日之前，请尝试熟悉如何整理文档缺陷，阅读 关于我们的缺陷整理指南。
2. 确保你已加入 Launchpad 中的文档缺陷组：[[1]]。
3. 通过阅读 文档联络人列表，了解每个项目的文档项目交叉项目联络人。
4. 在活动日加入 Freenode IRC 网络上的 #openstack-doc，以便与大家沟通。
5. 选择以下任务中的一个或多个

理解文档缺陷

1. Launchpad 缺陷区域 openstack-manuals 是文档缺陷的默认区域，应用于来自这些仓库的文档
   • clouddocs-maven-plugin
   • openstack-doc-tools
   • openstack-manuals,
   • operations-guide
   • security-doc
2. Launchpad 缺陷区域 openstack-api-site 用于所有 API 仓库
   • api-site（包括 API 完整参考）
   • compute-api（即将迁移到 openstack-attic）
   • identity-api（即将迁移到 openstack-attic）
   • image-api（即将迁移到 openstack-attic）
   • netconn-api（即将迁移到 openstack-attic）
   • object-api（即将迁移到 openstack-attic）
   • volume-api（即将迁移到 openstack-attic）

整理文档缺陷

在缺陷整理日你能做的最好的事情是在文档缺陷上编写详细的评论，以便任何人都可以直接创建修复。全天在 IRC 上寻求文档团队或联络人的帮助。

缺陷列表在这里

• OpenStack 手册中的缺陷
• API 站点和 API 参考中的缺陷

1. 如果你认为缺陷在整理后很容易或直接修复，请用“low-hanging-fruit”（低垂的果实）标记它，以表明有人可以轻松地接手它。
2. 如果一个缺陷被标记为 Confirmed（已确认），请仔细查看它，研究它以查看你是否可以整理它，然后将其设置为 Triaged（已整理）。
3. 我们的大部分缺陷都已标记有意义的标签，但如果你认为缺少标签，请添加标签。这里有一些标签建议。

如果你对 OpenStack 的某个部分很了解，请在特定缺陷上编写任何建议的文本或提示，说明如何记录它。以下是按类别划分的细分

• Nova
• Swift
• Xen 相关
• neutron
• Cinder
• Glance
• Keystone

我们还使用以下标签标记 Launchpad 项目中的文档工具缺陷：doc-builds 或 doc-tools。这些不是整理的重点。我们想专注于内容文档缺陷。

关闭旧的已修复缺陷

旧的缺陷很糟糕。即使它们已经很久以前就已修复，它们也会阻塞缺陷视图并使列表无法使用。只需查看旧的缺陷并检查它们是否仍然适用！如果它们不适用，请将它们关闭为 FixReleased（如果你可以确定修复时间）或 Invalid（如果你无法确定）。

获取帮助

如果你需要知道某件事的归属、修复构建失败或批准审查方面的帮助，请在指定时间内在 #openstack-doc 上联系以下人员。

请注意，如果你无法整理文档缺陷，只需继续下一个！有了近 600 个文档缺陷，有很多可供选择。

UTC	导师	时区交接
2300	这里有名字	澳大利亚
0000	这里有名字
0100	这里有名字	亚洲
0200	这里有名字
0300	这里有名字
0400	这里有名字	印度
0500	这里有名字
0600	这里有名字
0700	这里有名字
0800	这里有名字	欧洲
0900
1000
1100
1200
1300
1400	这里有名字	美国东部
1500	annegentle	美国中部
1600	annegentle
1700	annegentle	美国西部
1800	annegentle
1900	annegentle
2000	annegentle
2100	annegentle
2200	这里有名字

时区转换

---