成为技术文档工程师之前,我曾做过几年总经理助理,负责有关国外业务的一切事宜。

在那几年的工作中,我频繁地接待客户,与公司内的各个部门沟通协调,风风火火的。

成为技术文档工程师之后,第一次有种“世事喧嚣,与我无关”的感觉。

但这份清闲并没有带来“面朝大海,春暖花开”的宁静与闲适,反而有种“说不定明天有什么意外”的担心与慌乱。

后来,我接触到的同行越来越多,有国内的,也有国外的。

无论职位高低,从事这个岗位的人们似乎非常容易感染一个共性:虚了一点儿气场,缺了一点儿自信。

虽然在公开演讲、同行聚会和博客论坛中,大家经常宣传这个工作岗位有多么重要(价值)、需要的技能有多么难以修炼(专业度)以及发展前景如何如何(潜力),但是走下讲坛之后依然要回归现实:

这是一个很小众的边缘岗位,没有存在感,还经常吃力不讨好。

缺乏职业认同感
缺乏职业认同感

很多岗位是外包岗,天花板比较低,员工往往没有归属感,稳定性差。

技术文档工程师有很多外包岗
技术文档工程师有很多外包岗

甚至招聘过程也可能套路满满,一步一个大坑。

这是外包套娃?

行业现状,不可能在朝夕之间发生明显改观。

但人生短暂,身处其中的我们就只能在默默承受和愤而转行之间二选一吗?

打造专业标签

迈克 (Mike F. Robbins) 是微软的一名技术专家,非常擅长编写 PowerShell 脚本。

他曾荣获 2013 年脚本大赛高级组的冠军和 2014 年微软最有价值专家奖 (Most Valuable Professional, MVP)。

他独立编写或参与编写了好几本 PowerShell 方面的专业书籍,比如《PowerShell 101》和《PowerShell Deep Dives》。

除了自己的网站,他还为其他杂志和博客网站撰写 PowerShell 方面的客座文章,比如 PowerShellMagazine。

看到这些信息,你猜他是做什么工作的呢?

做程序开发的技术大牛? 错了!

他的第一身份是微软 Azure PowerShell 的首席技术写作专家 (lead technical writer)。

是否精通所属行业的专业知识,是技术文档工程师经常被质疑的一点。

毕竟,所有的产品文档都需要向别人讲解一些东西或教别人学一些东西。

老话常说,要给别人一滴水,自己得有一桶水。

如果自己都一知半解,写出来的文档怎么可能让别人一读就懂、一学就会呢?

打造专业标签的方法有很多,而出书是最传统、最硬核的一种。

“各个领域的专家都认为,总有一天自己得出本书,以此奠定自己的专家地位。”

如今的数字化阅读时代,出书已经可以 100% 自助了。是自助,不是自费哦!

国外有很多自助出版平台(比如亚马逊 KDP、Smashwords 和 LeanPub),允许作者完全按照自己的想法和进度管理书籍的整个出版过程,从写作、编辑、排版、设计,到定价、推广和营销等。

书籍售出后,平台会根据售价向作者支付一定比例的版税(即报酬)。

我在很多技术类博客上看到过博主自助出版的书籍(以教程为主)。 迈克写的 《PowerShell 101》 就是自助出版的,发布在 LeanPub 上。

“自助出版的图书很难成为畅销书,但偶尔也会有个例外。例如,史上最成功的商业畅销书之一《富爸爸穷爸爸》就是作者罗伯特·清崎自助出版的。”

养成创业精神

安迪(化名)曾是摩门教会 (Mormon Church or LDS Church) 的一名技术文档工程师,归属于信息通信系统组 (ICS group)。

没想到,他刚刚入职不久就遭遇了公司大裁员

他所在的团队共有 6 名技术文档工程师,在那次裁员中几乎被团灭。只有一个人幸免,因为他还要继续负责知识产权方面的工作。

这是他第一次被裁员,但却不是第一次经历裁员。

加入这家公司之前,安迪在 IBM 工作了 11 年。11 年里,他经历(挺过)了 12 次裁员。

他不想一次次地沦落到如此被动的境地。他决定,再也不给别人裁掉自己的机会。

之后,安迪成立了自己的公司,提供技术写作以及 MadCap Flare 软件的定制、咨询和培训服务。

他的第一个客户,就是裁掉他的前东家 —— 摩门教会的信息通信系统组。

他的公司业务发展地特别好,尤其是 MadCap Flare 软件方面的业务。

然而,在当了 6 年的老板之后,他又怀念起了当年做技术文档工程师的日子。

于是,安迪将自己公司的业务交给了当年和他一起被裁的一个前同事,自己就乐呵呵地到其他公司去找了一份全职的工作。

安迪是技术传播博主汤姆 (Tom Johnson) 的前同事。对,当年他们一起被裁员的。

汤姆在他的博客网站 I’d Rather Be Writing 上发布了一篇题为《为什么技术文档工程师在公司里总被视为边缘职位?》的客座文章。

本来这篇文章只是为了答复一位网友的咨询,没想到文章发布后引起了许多技术文档工程师的强烈共鸣,纷纷在评论区各抒己见。

网友的热议使汤姆想起了自己多年前被裁员的经历。

为了更深入的探讨这一话题,他逐一回访了当年的 5 位同事,并将他们的故事和见解以系列文章的形式发布了出来。

安迪的故事便是其中之一,也是所有故事里最魔幻、最个性、最带劲儿的一个。安迪是化名,但他的故事可不是虚构的。

技术文档工程师经常被认为是一个杂而不精的工种,论对用户需求的理解不如产品运营和市场营销,论掌握产品技术的能力不如技术专家 (SME) 和技术支持,论写作能力……em……他们说没必要论……谁还不会写几个字呢!

但正是这样一个杂而不精的边缘工种,才有可能暗藏投资少、风险低、可能性多的创业机会。

安迪开始创业时,接触 MadCap Flare 的时间不足一年,妥妥的新手。

不过,他在 IBM 时一直使用 DITA,还拥有项目管理的经验。

当这些“杂而不精”的经验和技能,遇上前东家裁撤内部部门转外包的时机,不就是职场边缘人因祸得福的大好机会吗?

“创业可以让一个人焕发出强大的力量。”

安迪在创业过程中经历的许多挑战,促使他完成了很多原本不可能完成的事情,最终成长为一个意想不到的自己。

当别人不给自己机会时候,自己一定要给自己一个机会。

很多西方的工会领袖不就是因为没有在公司中发挥领导才能的机会,才跑到工会去发挥个人才能了嘛,比如 Walter Reuther。

走向前台

汤姆 (Tom Johnson) 是博客网站 I’d Rather Be Writing 的博主,也是一名拥有将近 20 年工作经验的技术文档工程师。

在成为技术文档工程师之前,汤姆做过大学老师,做过营销文案。

但因为这些工作的收入比较低,不足以养家糊口,他才决定转行做技术文档工程师。

做营销文案时,汤姆曾经写过一些关于蛋白质药物的科普内容。凭借这份科普内容,他顺利转行,成为了美国瑞杰金融集团的一名初级技术文档工程师。

那时,正是博客风靡之时。爱好写作又有一些网站设计经验的汤姆,开始运营自己的博客网站 I’d Rather Be Writing,分享技术写作方面的知识和经验。

“博客可以让你通过互联网向全世界分享自己的想法和观点,是宣传自己的最佳方式之一。”

当时的汤姆肯定不会想到,他的博客竟在日后给他带来了不只一次不可多得的工作机会。

摩门教会裁员事件之后,汤姆决定去高科技企业云集的硅谷发展。

可去了之后却发现,硅谷的工作对应聘者的技术能力要求很高,他还达不到那个水平。

这时,好运驾到!该领域内的一名资深猎头是汤姆的博客粉丝,他向当时正火的游戏化创业公司 Badgeville 极力推荐了汤姆。

粉丝的力荐使汤姆顺利入职,虽然他当时并不完全具备岗位要求的技术能力。

这次入职,也成为汤姆职业生涯中的一个重要里程碑:这是他第一次涉足 API 文档,他在未来十年(甚至余生)一直深耕的技术写作细分领域。

有了两三年的 API 文档写作经验之后,汤姆受到一位猎头朋友的“涨薪鼓惑”,决定去应聘科技巨头亚马逊的技术文档工程师。

又一次,好运驾到!其中一位面试官也是汤姆的博客粉丝,他在整个面试过程中一直力挺汤姆,说他在一篇博客文章中表达的想法与他们现在正在寻找的东西完美契合。

这次入职,对汤姆的职业生涯同样意义重大。他不仅能在 API 领域进一步深耕,还有了大公司的工作经验作背书,开始成为别人眼里的 API 文档专家。

他开始收到一些公司和社区的培训邀请,希望他去讲授一些 API 文档方面的实操课程(工作坊)。

“借助一种职业的专业知识和人际关系来构建另一种职业,是一种常见的斜杠职业发展技巧(职业拓展方法)。”

汤姆当然不会错过这样的机会,于是他顺势开发了 API 文档课程(教程),颇受好评。

讲到这里,汤姆的职业生涯貌似很圆满了,亚马逊应该足以让他呆到退休。

汤姆原本也希望这样,但他在硅谷也经历着和“北上广深”打工人一样的痛:昂贵的房价和一眼忘不到头的租房生活。

然后,在亚马逊工作了 5 年之后,汤姆决定搬到更宜居的华盛顿去。那里有好几家高科技公司,应该也有不错的工作机会。

他现在是谷歌的技术文档工程师,已经在那里工作了将近 3 年了。

2021 年,他曾受邀参加 tcworld 中国大会,发表了一场题为《技术传播和市场营销:如何让你的技术传播团队在公司内部更受关注》的主旨演讲。

你可以在 I’d Rather Be Writing 网站上找到这场演讲的详细资料,视频、音频、PPT、背景故事等,还有他历年发表的所有演讲们……

“写作、演讲、培训和咨询这四种斜杠职业,就像黑色长裤一样属于百搭款,可以与任何职业搭配组合。”

除了汤姆,还有很多技术文档工程师在使用同样的方式展示自己。或许,你也可以试试?

参考资料

  1. Mike F. Robbins. PowerShell 101: The No-Nonsense Beginner’s Guide to PowerShell [M/OL]. LeanPub, 2018: i~ii.
  2. 玛希·埃尔博尔. 成就斜杠人生:未来全新的工作模式[M]. 毛大庆, 译. 北京: 北京联合出版公司, 2020.
  3. Tom Johnson. Reflecting seven years later about why we were laid off: Part I-VI [OL]. (2020-7-1)[2023-10-21].
  4. Tom Johnson. My life story, or reflections on what shaped my life’s career trajectory [OL]. (2021-3-18)[2023-10-21].
  5. 波得·德鲁克. 管理的实践[M]. 机械工业出版社, 2019.