Documentation/BugDay
日期:2015年4月23日 星期四
时间:只要你醒着!
沟通:#openstack-doc 在 Freenode IRC 网络上
目标:尽可能地处理 openstack-manuals 中的文档错误。
如何参与
- 在活动日之前,请尝试熟悉 如何贡献文档
- 在活动日加入 Freenode IRC 网络上的 #openstack-doc 频道,以便与大家沟通
- 选择以下任务中的一个或多个
修复错误
在错误修复日你能做的最好的事情就是解决一个现存的错误。只需查看 已确认 或 已分类 列表并选择你的目标。提交一个修复它的补丁。在频道寻求评审帮助。
错误列表在这里
- 如果你只觉得可以进行小改动,请查找带有标签 low-hanging-fruit 的错误
- 如果你找不到 low-hanging-fruit 来修复,你也可以尝试完成 BugTriage 中描述的任务
- 接下来,标记为 “Triaged” 的错误包含一些有用的提示
- 然而,大多数错误标记为 Confirmed
向文档团队提供信息
你不需要编辑文档来协助本次错误修复日。如果你熟悉 OpenStack 的某个部分,请在特定错误上编写任何建议的文本或提示,说明如何编写文档。以下是按类别划分的细分
- 安装指南 < 这些是最高优先级。
- 计算 (nova)
- 对象存储 (swift)
- Xen 相关 (用于计算)
- 网络 (neutron)
- 块存储 (cinder)
- 镜像 (glance)
- 身份验证 (keystone)
我们还使用 doc-builds 或 doc-tools 标记这些 Launchpad 项目中的文档工具错误。
关闭旧的已修复错误
旧的错误很糟糕。即使它们已经存在很长时间,它们也会阻塞错误视图并使列表无法使用。只需查看旧的错误并检查它们是否仍然适用!如果它们不适用,请将它们关闭为 FixReleased(如果你可以确定修复时间)或 Invalid(如果你不能确定)。
分类错误
如果你是 OpenStack 操作员或开发人员,你可能能够提供有关如何编写特定主题的有用信息。只需将你能提供的信息粘贴到错误中并单击提交。这将使我们更进一步,即使是小步骤也值得赞赏。
准备工作
- 重新生成所有配置表,因为许多错误可以在重新生成后标记为已修复,并且重新生成补丁可能不会将所有错误标记为已修复。
获取帮助
如果你需要有关放置位置、修复构建失败或批准评审的帮助,请在指定时间内通过 #openstack-doc 联系以下人员。
请注意,如果你无法使某些内容构建 - 仍然提交以供评审!我们可以查看并修复它。
| UTC | 导师 | 时区交接 |
|---|---|---|
| 2300 | loquacity | 澳大利亚 |
| 0000 | loquacity | |
| 0100 | loquacity | 亚洲 |
| 0200 | loquacity | |
| 0300 | loquacity | |
| 0400 | loquacity | 印度 |
| 0500 | loquacity | |
| 0600 | loquacity | |
| 0700 | gpocentek | |
| 0800 | gpocentek | 欧洲 |
| 0900 | gpocentek | |
| 1000 | gpocentek | |
| 1100 | gpocentek | |
| 1200 | gpocentek | |
| 1300 | gpocentek | |
| 1400 | annegentle, gpocentek | 美国东部 |
| 1500 | annegentle, gpocentek | 美国中部 |
| 1600 | annegentle | |
| 1700 | annegentle | 美国西部 |
| 1800 | annegentle | |
| 1900 | annegentle | |
| 2000 | annegentle | |
| 2100 | annegentle, loquacity | |
| 2200 | annegentle, loquacity |