关于Uber的技术写作,你需要知道的7件事

0
关于Uber的技术写作,你需要知道的7件事

在这篇文章中,Uber技术作家和前实习生Shannon Brown解释了她作为技术作家的工作,并回答了关于Uber工程组织中这一重要角色的常见问题。

一年多前,我第一次走进优步(Uber)在旧金山的办公室。我开始了为期12周的实习,这将把我引入技术写作的世界,但我不知道该期待什么。

反复出现的问题,如技术写手实际上是做什么的?而且我想长期在优步工作吗?一直在我脑海里闪过。在我实习的过程中,这些问题的答案越来越清晰。暑假结束时,我自信地认为这就是我想要追求的道路,这份工作让我激动地接受了。

大学毕业后选择工作时,我从来没有遇到过这样的问题我想做什么?而是我怎么才能做到这些呢?我想找一份既能发挥创造力又能分析能力的工作。我想要处理很酷的技术概念,但我对不断地写代码不感兴趣。我希望有一份能让我敢于冒险、每天都能学习的工作。令人惊讶的是,技术写作检查了每一个框。

技术写作可能是一个被误解的职业,所以我把我的经验总结为七个我经常问自己的问题。希望未来的作者和技术人员会发现这些答案对决定技术写作角色有所帮助。

技术写手实际上是做什么的?

尽管我在网上花了好几个小时进行研究,但直到我全身雷竞技是骗人的心投入实习工作,处理大量令人兴奋的项目时,我才终于觉得自己掌握了技术写手的确切工作。

通常,技术作者记录工程师开发的服务或产品。这些文档帮助新用户,传播关于服务如何工作的信息,并将技术术语翻译成易于理解的散文。然而,文档只是技术作者的众多任务之一。除了文档之外,技术作者还创建培训材料、分析数据、采访用户、编写产品内部副本,并提出信息架构问题的解决方案。有时候你得像工程师一样思考,有时候你得像项目经理一样思考。这份工作充满活力,富有挑战性,而且回报丰厚。

作为一名技术写手,最大的挑战是什么?什么是最有价值的?

作为Uber的一名技术写手,我同时在多个项目上与多个团队合作,这导致了大量的上下文切换和多任务处理——有时是一个挑战!我必须非常高效和有条理地安排我的时间,以确保我在截止日期前完成任务,并为与我共事的团队提供良好的服务。

因为我和多个团队一起工作,我也有很大的机会产生影响。这是非常有益的,因为我写的文档和我创建的学习内容可以帮助我的同事更快地理解、处理和学习信息——这是Uber工程部门效率和生产力的巨大红利。

关于技术写作最大的误解是什么?

由于技术写作并不是一个非常知名的职业道路,所以有很多误解。对我来说最突出的一点是,技术写作很无聊。

这是完全错误的(除非你讨厌读和写,不想和很酷的技术有任何关系)。

事实上,这份工作一点也不无聊。正如我之前提到的,我参与了很多有趣的项目。如果我对一件事感到厌烦,我可以休息几个小时做另一件事。这让我保持专注,这样我在工作中就不会感到无聊。

关于技术写作的另一个主要误解是,你必须有技术背景。正如你将在下一节中读到的,这也是错误的!

你需要一个工程学位或背景才能成为一名技术作家吗?

许多人认为你需要一个工程学位或背景才能成为一个技术作家,这实际上是另一个很大的误解。

在大学里,我学习了计算机科学、音乐和艺术。虽然我的计算机科学课程帮助我了解了技术概念,但我所受教育中最有用的方面实际上是学习如何学习和倾听。我在学校学习的一些技术工具和概念对我作为一名技术作家的角色有帮助,但更重要的是,它们让我快速学习和提出问题,这对技术写作工作至关重要。

技术作家来自不同的背景,你不需要一个工程学位或背景来开始这个领域(尽管它绝对没有坏处!)。如果你有很强的写作能力和学习的欲望,技术写作可能非常适合你。

我觉得在Uber做技术写手怎么样?

无论你处于职业生涯的哪个阶段,无论你拥有什么头衔,你都必须考虑你所效力的公司是否符合你的目标和价值观。我在优步(Uber)的暑期实习经历,以及过去几个月的全职员工经历,都向我证明,没有哪个地方是我更愿意去的。

在优步工作最好的地方是人。当我刚来的时候,无论是作为实习生还是全职员工,我的团队成员都不遗余力地欢迎我并指导我——这并不是我的团队所独有的。我在优步遇到的每个人都很善良,热情,对他们的工作充满热情。办公室里的活力是有感染力的,强烈的社区意识和自豪感让我每天都期待着来上班。

我很感激Uber是一个可以让我建立职业生涯的地方,这得益于向上和横向的流动性。我的一个同事刚刚从技术作家的角色转变为软件工程师的角色,另一个转变为项目经理的角色,所有这些都在Uber内部。我喜欢优步支持这种运动。

特别是从技术写作的角度来看,我认为Uber是一家很棒的公司。我得到了来自各个管理层的支持,他们真正看到了技术写作的价值。感谢你们的支持,我知道我的工作很重要。这有助于我在从事具有挑战性的项目时保持动力。

最后,成为Uber大家庭的一员让我很兴奋,因为我们所做的工作不仅对现在有很大的影响,而且对未来也有很大的影响。我很高兴能成为一家正在彻底改变运输业的公司的一员。

与其他公司相比,Uber的技术写作有什么不同?

因为我的行业经验有限,所以我找了Uber的一位科技作家同事,就这个话题发表了看法。

资深技术作家亚当·帕夫拉克(Adam Pavlacka)表示,优步专注于利用工程师编写文档,并真正鼓励良好的文档文化。许多公司雇佣写手仅仅是为了提供文档或根据工程师的笔记重写原始文本,而优步雇佣的技术写手会以一种亲力亲为的方式了解他们所写的主题。

你会给一个有抱负的技术作家最大的建议是什么?

如果你想成为一名技术写手,现在就开始写吧!你不需要有正式的工作来练习你的专业写作技巧。找到你使用的产品或应用程序的现有文档,看看如何改进它。负责记录需要文档帮助的开源项目。看看那些让你兴奋的技术概念的在线教程。这些小步骤将帮助你建立你的投资组合和发展你的技能。

如果你认为自己不够“技术迷”,或者你不符合技术作家的标准,我也敦促你不要放弃成为技术作家的想法。没有霉菌!如果你是一个有抱负的技术作家,让你的欲望驱动你走向成功。

如果与Shannon和她的团队一起编写引人注目的文档吸引你,可以考虑申请一个角色加入Uber的技术写作团队!

订阅我们的通讯以跟上优步工程公司的最新创新。

评论