是的,内容确实可以堆栈,我想描述一下我们现在正在进行的一些内容堆栈。这就像升级我的爱车,名词在哪里,动词在哪里?
堆栈构建中
OpenStack 社区已经拥抱了技术内容,周围的社区渴望获得更多。我们得到了社区成员的极好贡献。对我来说,亮点之一是 David Pravec (alekibango 在 IRC 上) 的热情和友好的提问,以及他的 Etherpad 中的大纲,为 Nova 手册提供了极好的起点。他还坚定地认为我们正在创建手册,而不是指南,提供精确的信息而不是仅仅提供指导。我们还有 Stephen Milton (grizzletooth 在 IRC 上) 站出来并接手了 Swift All In One 页面,并在多台服务器上进行了测试,提供了一个 全新的多服务器安装和部署页面,我们仍在草拟中。一位来自佛罗里达州的学生 Eric Dorman (Orman 在 IRC 上),正在学习云安全,正在为 OpenStack 编写安全文档。这种参与度让我非常鼓舞,感谢大家。
我们有一个 文档 页面,用于存储我们已经开始的页面集合,并概述需要编写的页面的计划。我非常喜欢这篇博文,为 Open Atrium 编写文档两个月和管理新闻 – 经验教训!,并从中借鉴了大纲的想法。它证实了我的想法,即人们对技术文档的完整性有很多期望,并且 这个大纲,一旦填满,将为 OpenStack 文档带来“完整性”的感觉。
nova.openstack.org 和 swift.openstack.org 站点应该在本周结束时配备好 Google Analytics。我们应该很快将 Google Analytics 集成到 wiki 中。这种集成将为我们提供关于哪些页面经常被查看、哪些搜索将人们带到该站点以及他们在 wiki 上的路径等方面的想法。
一个让我有点惊讶的工作领域是使用 Etherpad 来编写草稿,并在将其放置在 wiki 或 RST 上之前与小组成员协作。我们已经将 Etherpad 页面编码为 RST,因此只需简单地复制/粘贴即可将 RST 导入 Sphinx 构建。我理解在 wiki 上编写草稿的感觉就像在手术台上进行文档处理,内脏暴露在外。因此,像 Etherpad 这样更私密的协作区域似乎弥合了 wiki 页面草稿和早期、早期草稿之间的差距。
文档冲刺
我正在为即将到来的文档冲刺(OpenStack 设计峰会的最后两天)制定议程。所有时间均为中部标准时间 (GMT -6)。目前看起来是这样
11月11日 星期四
9:00-10:00 参加安装节并安装环境,更新安装
说明
10:00-10:30 wiki 或 RST 培训(根据需要),计划写作
任务
11:00-12:00 写作
12:00-1:30 午餐
1:30-2:00 社区经理 Stephen Spector 将谈论文档
认可
2:00-4:00 写作
4:00 结束当日签到(IRC 和/或电话会议)
6:00 不要忘记周四晚上有派对,所有文档贡献者都
欢迎!巴士将于下午 6:00 从 Weston Centre 大堂出发。
11月12日 星期五
9:00-12:00 写作
12:00 中午签到(IRC 和/或电话会议)
12:00-1:30 午餐
1:30-4:00 写作
当日结束的签到使我们能够与远程贡献者联系,切换写作任务,提问等等。如果您计划远程参与,请告诉我,以便我满足您的需求。我们将在全天 #openstack IRC 频道上,如果您想收听 Spector 的演讲,我们可以使用电话会议或 Skype。
官方内容堆栈
本季度的目标之一是找到一种区分“官方”文档和“正在进行中、测试中”文档的方法。无论是在页面上添加徽章,还是使用全新的 URL,例如 docs.openstack.org,我都非常希望您能分享您对如何指示文档经过测试、审核并为官方文档的想法。我有一些想法和示例,但社区的意见很重要,并且在决策中具有影响力,因此请提出您的想法。您可以发送电子邮件至 anne at openstack dot org,在 IRC 上找到我 annegentle,或在 Twitter 上找到我 @annegentle。
发表回复