如何在 OpenStack 中成功地成为远程文档贡献者

Alexandra Settle 在巴塞罗那 OpenStack 峰会上的演讲预告
4 位读者喜欢这篇文章。
Sky with clouds and grass

Flickr 用户:theaucitron (CC BY-SA 2.0)

Alexandra Settle 是 Rackspace 的信息开发人员,她将在巴塞罗那的 OpenStack 峰会上发表演讲。Alexandra 是 OpenStack 手册的核心审阅者,也参与 OpenStack Ansible 和 Swift 项目文档的工作,并在 Outreachy 项目中担任文档导师。她从高中起就对信息技术感兴趣,并且是 Fedora Linux 的爱好者。她最初在 Red Hat 实习,在使用 Windows 机器多年后,她喜欢上 Linux 的易用性和功能性。

在这次采访中,Alexandra 分享了 她的演讲 的预告,内容是关于在家工作的最佳实践,以及在开源项目工作中如何成为强大的沟通者。

制作优秀文档的秘诀是什么?

我不会说制作优秀文档有什么“秘诀”。优秀的文档很少由一个人完成——它始终是团队努力的结果。如果你撰写初稿,或者可能是文档的更新,协作是你成功的关键。你的原始文档应该始终有多人审阅,一位编辑(如果你的团队有的话),对于技术文档,应该始终有一位 SME(主题 matter 专家)提供指导。你不能对自己的写作过于敏感。没有人是完美的,你的写作也不会是。而且,当你与其他人合作时,你会学到更多。

你如何保持读者对高度技术性文档的兴趣?

高度技术性的文档不是人们倾向于睡前阅读的东西。幸运的是,我为开发人员和运维人员社区写作。安装指南、网络指南和升级指南对于他们正常工作至关重要。然而,在过去几年中,我从支持人员、运维人员和开发人员那里收到的反馈相当一致——保持简单(但永远不要使用“简单”这个词:它从来都不简单,而且会冒犯那些不觉得简单的人)。技术文档应该告诉你做什么、怎么做,以及在必要时提供一些背景信息。如果将其控制在这些范围内,你的受众会欣赏你的产出。

我/我们应该在家工作的首要三个理由是什么?它如何同时既棒又糟糕?

你应该在家工作的三个理由

  1. 工作/生活平衡。 假设你与雇主或经理有良好的沟通,你通常可以按照与朝九晚五的同事不同的时间表工作。这使你能够做一些简单的事情,而当朝九晚五工作时,这些事情可能会成为生活中痛苦的根源(例如,去邮局。工作后总是关门,这有多烦人啊!)。

  1. 你自己的空间。 我无法强调拥有自己的办公室、自己的舒适设施、食物以及不必为了办公室而盛装打扮的选择有多么美妙。当你在精神上感到满足时,它可以创造一个非常高效的环境。

  1. 加入联合办公空间。 对于任何愿意每周几天去办公室,但又不是“那个办公室”的人来说,这是一个很棒的主意。我加入了一个位于布里斯班西区的名为 The Swarm 的空间。他们不再运营了,但这个美丽的空间是由建筑师翻新和设计的——他们实际上在楼上的空间工作。我能够结识各种创意人士和技术人员,他们都在从事各种各样的项目。这是一个绝佳的社交机会,如果你在办公室工作,你不会得到这种机会,我会认真地向任何人推荐它。

在家工作很棒,原因是我上面列出的所有理由,自由感是朝九晚五的生活无法比拟的。但是,当你没有管理好自己的时间时,它可能会变得很糟糕。我遇到的最大的困难之一是缺乏社交。我是一个非常喜欢社交的人,但我在在家工作的第一年就意识到,我与朋友见面的次数减少了,在“工作时间”之外花更多的时间在电脑上(不停地查看电子邮件,查看我对文档补丁的更改是否已合并,浏览 Buzzfeed,并变得越来越孤立。这是一个非常难打破的循环。我的工作受到了我对生活缺乏热情的影响,在面对我的问题后,我能够重新审视在家工作和工作/生活管理。

是对所有这些事情的相当准确的解释,我在 Linux Conf 演讲中使用了它。

当在家工作时,你如何维护你所工作的组织的文化?

这非常困难,但幸运的是,我与一个在家工作的团队一起工作。至少,文化是通过 Slack 或 IRC 等沟通平台(我个人的偏好)来维护的。即使是通过文本媒介了解彼此,也允许团队培养内部笑话、参考资料、谈论电子邮件、工作,甚至可能是个人物品。至于维护组织的文化——这绝对是一项更艰巨的任务。根据经验,我会说维护组织文化的最佳方式是参与其中。无论是通过联系最近的办公室并组织访问,参加他们当地关于公司问题的会议(拨入或视频接入),还是加入社交委员会并报告你和你团队的外部活动。例如,我们的在家工作团队在一个月发现悉尼办公室正在举办披萨午餐。我和另一位同事在 IRC 上发起了一场虚假的“政变”,在与我们的老板谈判后,我们有了 2014 年的伟大披萨订单。公平地说,这并没有变成披萨。但是,我们确实查看了我们的团队预算,我们能够为每个人组织特定城市的团队郊游以及午餐和电影。

Outreachy 如何帮助你成长?与 Outreachy 的实习生合作有什么优势?

Outreachy 为我提供了一个平台来帮助他人。虽然我真心喜欢教导别人并看着别人成长和学习——但我在这方面很糟糕。我,自认,非常没有耐心——这对于老师来说是一个可怕的品质。技术并不总是人们会立即感到舒适的东西,这是可以理解的。通过导师/学员计划,我被教导(最肯定的是被学员们教导)要有耐心——当你远程尝试通过 IRC(有时也通过语言障碍)教导某人如何排除他们的问题时,这非常重要。向某人发送“让我为你谷歌一下”的链接不会为你赢得任何朋友。

多样性是与 Outreachy 实习生合作的主要优势。Outreachy 计划最近一轮的重点是国际上的女性(顺性别和跨性别)、跨性别男性和性别酷儿人士。我有机会结识许多与我背景非常不同的人——这真是令人大开眼界。

User profile image.
教育家、企业家、开源倡导者、终身学习者、Python 教师。教育心理学硕士,教育领导学硕士,Linux 系统管理员。

2 条评论

很棒的文章,Alexandra 和 Don!虽然我喜欢为了会议而与同事保持物理上的接近,但肯定我最高效的日子是我在家工作的日子。我很高兴能有灵活性来兼顾两者。

谢谢 Jason!我也喜欢在家工作。但是,见到同事本人总是很棒的。Skype、FaceTime 和其他虚拟会议肯定彻底改变了讨论方式。

回复 作者 Jason B

Creative Commons License本作品根据知识共享署名-相同方式共享 4.0 国际许可协议获得许可。
© . All rights reserved.