About

VMware 的 Abigail 谈开源文档

Author Tanmer Tanmer
Tanmer · 2025-06-16发布 · 3 次浏览

在知识库忍者播客中,VMware 员工 Abigail McCarthy 分享了她从技术写作到管理角色的转变,讨论了开源文档的流程与挑战,以及她在职业生涯中的成长与学习。

在知识库忍者播客的这一集中,Gowri Ramkumar 与 VMware 员工开源技术通信经理 Abigail McCarthy 一起参与其中。他们讨论了阿比盖尔从技术写作到管理角色的转变、开源文档流程的意识形态以及技术作家职业生涯中最大的挑战。

主要事实

  • 阿比盖尔的LinkedIn

  • VMware网站

  • 阿比盖尔拥有锡耶纳学院计算机科学学士学位

  • Abigail 与 VMware 合作已超过三年

  • VMware 开发创新方法,使技术能够无缝协作。他们的云、移动性、网络和安全辅助工具构成了数字基础,为当前正在改变世界的应用程序、服务和体验提供动力

要点

  • 阿比盖尔将她向技术写作的转变称为一次“幸福的意外”。她甚至选择了计算机科学专业,因为它涉及的写作量最少。然而,当她完成学业并开始担任网络开发人员后,她意识到自己想做一些不同的事情

  • 在与朋友交谈并做了一些研究后,她意识到她作为网络开发人员的工作也涉及一些技术写作。她在不知不觉中自然而然地被它吸引了。一旦她开始从事技术写作,她发现这正是她正在寻找的东西

  • Abigail 表示,VMware 的文档大部分都是开源的,可以在互联网上获取

  • 她的所有工作都在GitHub和免费存储库上完成,以帮助消费者

  • 阿比盖尔相信参与社区可以获得客户的见解,主动了解即将推出的功能,并定期与开发人员沟通以了解他们的参与度。为了控制信息流入,她尽早参与流程以了解一般文档要求

  • 创建文档后,Abigail 会详细审查与产品设计和功能相关的内容,并亲自对其进行测试,以确保它们符合文档中提到的设计规范。她在审查阶段更新了所需的修改

  • 此外,她采访了利益相关者,他们建议对产品和设计规范进行核心更改,并将他们的反馈添加到文档中

  • 草案最终确定后,将由相关人员多次审核,特别是那些对产品功能进行更改的人员

  • 此后,该文件将被发送以供发布

  • 阿比盖尔分享说,她在职业生涯中面临的最大挑战之一是弄清楚如何在开源社区中编写文档。此前她曾是Docs的所有者,对文档内容拥有很大的发言权和控制权。然而,在开源环境中工作需要不同的心态,因为它允许任何人访问文档并进行更改。然而,随着时间的推移,阿比盖尔了解到这是鼓励参与并敦促社区为该文件做出贡献的好方法

  • 阿比盖尔从高级技术作家到通讯经理的转变使她能够与更大的团队合作并协助更广泛的项目。它使她能够创建文档社区、设置流程和模板、围绕文档创建文化,并让更多人参与该流程

阿比盖尔在她的文档生涯中从谁身上学到最多?

  • 凯利安·菲茨帕特里克 (KellyAnn Fitzpatrick)博士在阿比盖尔职业生涯刚起步时向她传授了技术写作的基础知识,并且是一位伟大的导师,为她灌输了信心

关键资源

  • 开发人员文档:工程师技术写作现场指南,作者:Jared Bhatti、David Nunez、Zachary Sarah Corleissen、Jen Lambourne 和 Heidi Waterhouse

阿比盖尔会给 20 岁的自己什么与文档相关的建议?

“多花一点时间写作;学习语法和基础英语”

订阅知识库忍者播客

  • 苹果

  • Spotify

  • RSS

推荐剧集

  • 知识库忍者播客主持人 Gowri 简介

  • 欢迎来到 Baklib 的 Saravana Kumar 的知识库 Ninjas

提交反馈

博客 博客

智能知识库,未来企业基石