在电影《成功的秘密》中,布兰特利·福斯特(迈克尔·J·福克斯饰演)表达了每个新毕业生的确切想法:“在我得到一份能给我经验的工作之前,我怎么才能获得任何经验呢?”
开始新职业时,最难的事情是获得经验。这通常会造成悖论。没有经验如何获得工作,没有工作如何获得经验?
在开源软件世界中,这个难题不那么令人生畏,因为你的经验取决于你的付出。通过与开源软件(OSS)公司赞助的开源项目合作,你获得了为你喜欢的项目工作的经验,这些公司让你感到重要,然后你利用这些经验来帮助找到工作。
大多数公司绝不允许新手在没有签署保密协议(NDA)或经过某种培训或安全检查的情况下接触他们的知识产权和附属品。然而,当你的源代码是开放的,世界上任何人都可以为其做出贡献(除了复制和使用它),这不再是一个问题。事实上,开源公司拥抱他们的贡献者,并创建社区,让学生可以轻松入门,并在编码、测试和文档方面找到自己的方向。大多数开源公司依赖他人的贡献来完成工作。这意味着贡献者免费工作仅仅是因为他们愿意。对于学生来说,这转化为无薪实习并获得一些真实世界的经验。
在 Our Best Words,我们决定开展一个试点项目,看看我们的学生是否可以在开源文档项目工作,并发现该经验有利于他们在新兴的技术传播职业生涯中起步。

(Laura Novich,CC BY-SA 4.0)
我是该项目的发起人和联络人,我联系了几家公司。给予我们最积极回应的公司是 GitLab。GitLab 是一家为 Git 仓库管理、问题跟踪和持续集成/持续交付 (CI/CD) 管道管理创建软件的公司。它的软件被全球成千上万的组织使用,并在 2019 年宣布其年经常性收入达到 1 亿美元。
GitLab 的 Mike Jang 将我与 Marcin Sedlak-Jakubowski 和 Marcia Dias Ramos 联系起来,他们离 OBW 在以色列的办公室更近。我们见面敲定了细节,每个人都有任务在 9 月中旬启动试点项目。Mike、Marcia 和 Marcin 为学生精心挑选了 19 个问题来解决。每个问题都为 OBW 学生标记为 *Tich-Tov-only*,任何不是 OBW 学生的贡献者都不允许处理该问题。
为了让学生做好准备,我用 GitLab 进行了几次演示。学生们以前从未使用过该软件,有些人非常紧张。由于 GitLab 的骨干是 Git,学生们已经熟悉的一种软件工具,因此学习起来并不太难。在演示之后,我向学生发送了一个 Google Drive 文件夹的链接,其中包含教程、常见问题解答和其他有价值的资源。
学生们被分配到的问题来自 GitLab 的文档。该文档是用 Markdown 编写的,并使用名为 Vale 的 linter(静态代码分析工具)进行检查。学生们的任务是修复 Vale linter 发现的问题。更改包括修复拼写、语法、用法和语调。在某些情况下,整个页面都必须重写。
由于我希望这个项目顺利成功地运行,我们决定将试点项目限制在我们 14 名学生中的 7 名。这使我可以更密切地管理项目,并确保每个学生在项目为期两个月的时间内只处理两到三个问题。

(Laura Novich,CC BY-SA 4.0)
参与此项目的 OBW 学生(附带他们的 GitLab 个人资料链接)有:
我们主要在 9 月和 10 月工作,并在 11 月结束了该项目。学生遇到的每个问题都放在看板上。我们定期举行站立会议,讨论我们正在做什么以及导致困难的任何问题。有很多教学时刻,我会帮助解决仓库问题、解决合并请求以及帮助学生理解实践中的技术写作理论。

(Laura Novich,CC BY-SA 4.0)
11 月来得比我们预期的要快,回顾过去,该项目结束得太快了。大约在中间,我收集了 Marcin、Marcia 和 Mike 的反馈,他们告诉我他们的体验是积极的。他们告诉我们,一旦我们完成,如果我们愿意,我们可以承担比最初分配给该组的配额更多的问题。
其中一名学生 Rachel Gottesman 正是这样做的。她完成了 33 个合并请求,并帮助重写了 GitLab 文档的页面。她对 13.7 版本的发布起到了至关重要的作用,GitLab 宣布 Rachel 是该版本的 MVP!我们在 OBW 非常激动!祝贺你,Rachel!

(Laura Novich,CC BY-SA 4.0)
Rachel 的名字出现在 GitLab 的 MVP 页面上。
我们正在为新的一年和新课程做准备。我们计划再次开展这个项目,作为我们的 技术传播专业人员软件文档 课程的一部分。
本文最初出现在 Our Best Words 博客 上,并经许可重新发布。
2 条评论