专门的文档日

与其在即将到来的 峰会 上进行文档冲刺,我决定为Cactus版本进行文档推进,安排两个专注文档日,时间为本周三,4月6日,和4月13日。我想通过这篇文章让大家了解情况。(哈,页面。)

我用一堆便利贴在白板上跟踪文档任务,并且在这个版本中将很多任务从“进行中”移到了“已完成”。但我希望有一天专门用于OpenStack文档,以继续为项目添加支持文档。

OpenStack doc task board

范围

Cactus版本的重点是计算服务的标志和API的参考文档,以及对象存储的日志信息。我们在这方面做了很大的努力,这些努力都整合到了openstack-manuals Launchpad项目中,并且Nova中提供了围绕标志的自动化工具。

我已经发布了 Cactus版本的计算管理指南草稿,并计划放置一个新的主页,以便读者可以浏览Bexar或Cactus(trunk)文档。对于专注文档日,范围缩小到以下主题:

目标受众

如大家所知,OpenStack为开发人员和系统管理员提供文档。基于RST的文档面向开发人员,而基于DocBook的文档面向系统和云管理员。这个专注文档日邀请面向这两个受众的作者,重点是上述主题。

地点

我将在旧金山,位于前身为Anso HQ的总部(更新:4月13日)。目前我们没有额外的写作空间,但如果您想一起吃晚餐,请联系我。

经过一天的写作和绘制图表后,我们需要一些饮料。一旦确定地点,我将在旧金山Mission区发布一个聚会地点。

结尾俳句

最后,来自Daniel Green的一首俳句,他为Atlassian写了一首 文档冲刺俳句,并赢得了他们的文档冲刺俳句比赛

无暇进食了。
应该写更多内容。
太迟了,没关系。

标签:

发表评论

您的电子邮件地址将不会被公开。 必填字段已标记 *