技术写作职业入门记

图片发自App

技术写作这一行，一晃就干了七年。

回头去看，这段经历居然也有

适应期、热恋期、平淡期和七年之痒。

当一个周期结束，一切归于平静之后，

挺想把这段经历记录下来。

一则留作纪念。

二则，常常会遇到初入行或者单兵作战的同行。

他们其中许多如同我当年一样，

有点迷茫，不太清楚努力的方向。

的确，在国内，这个职业还是太冷门，

无论是从业者还是学习资料都相对少的很。

所以，作为过来人，我想我或许可以输出一点东西，

虽不是什么高深理论，但至少都是实战经验。

希望能给初入行的同行们一点参考一点启发，

其中不足之处，也欢迎指正。

如果您是同行，

或者对于技术写作有您的看法，

欢迎您与我联系，相互交流。

我是这样入门的，你呢？

01

2007年，我读研一，检测技术与自动化装置专业。因为硬件白痴，大学期间各种电路相关的课程都是靠背题勉强及格的。所以，以我当时的认知，毕业以后能够成为一名程序员，是我那时最重要的奋斗目标。

研一第一学期，一边忙于满满当当的课程，一边把谭浩强的《C语言程序设计》看了两遍。理论准备的差不多了，我需要实践机会，而我的导师属于偏重于理论研究的类型，并不能为我提供实践机会。于是，第二学期一过完春节，我便开始写简历找实习。很顺利的，我进入了一家台资医疗器械的小企业。背着导师，在那里实习了半年多。当时用的主控是ATmega128单片机，用C写一些模块。因为这份实习工作是我实现做程序员目标的重要一环，我特别重视和认真。直到研二，实在分身乏术，忍痛终止了实习。

02

研二，进实验室，做导师助教，师兄们离校后做实验室大师姐（就是管理实验室的工作），查资料，翻译资料，用matlab做一些仿真和数据处理，写论文，一周两次的助教课，去点名，收发和批改作业，带本科生毕业设计，出考题，批改考卷……。忙忙碌碌中研二很快结束，迎来了暑假。

暑假之后就是校招，而就在此时，我突然不想做程序员了。写论文翻译资料的这一年，使本身就对文字有种谜之情怀的我，萌生出一个想法。有没有一种工作，它既与文字相关，又能用到我学了七年的专业知识？

于是，那个暑假，我一边写论文，一边翻了当时所有主流招聘网站，从搜索功能的职位选择里面的那些选项入手，看到感觉可能相关的选项再去查岗位职责和任职要求。就这样，我第一次认识了“IT文档工程师”这个职位。我和它在各方面看起来似乎都完美匹配。

03

我写了专门针对这个岗位的简历，随着各大公司秋季校招的开始，加入了找工作的大军。然而，针对此岗位的求职之路并不顺利，因为相比较于程序员，市场对此岗位的需求太少。我的简历几乎无处可投。我又重新写了一份针对程序员的简历，打算双管齐下，先生存下去更重要。

那是2009年的深秋，满树绿叶的时候就突然迎来了第一场大雪，暖气还没有开放，异常的冷。在突如其来的风雪中，我从清河小营的校区辗转于上地，中关村，望京甚至大望路的办公楼，程序员的职位面试了几家，并没有遇到特别合适的。

而就在此时，转机突然出现了。我收到了一条通知面试的短信。公司名称看起来似乎很陌生，百度一搜，发现不仅公司有点来头——测试测量领域国内最好的公司，而且我们实验室中一部分仪器（我每天需要用到的）就来自于此公司。按照短信通知的日期，我带着一种“我们还是挺有缘分的”心情赴约。

公司在北京郊区靠近北六环的一个村子里，有大大的园区，有操场、宿舍和食堂，和我印象中的写字楼形象反差很大，不过，我还是挺喜欢这种类似于学校的感觉的。

那天的面试，从早上10点持续到晚上6点，宣讲、笔试、群面、技术面、HR面、BOSS面，在天要黑下来的时候，我拿到了offer。之后，签三方协议，毕业答辩。回家过完春节后，在一个飘着小雪的日子，我正式报到开始实习。我清楚的记得那天，2010年3月8日，虽然走在风雪中，依然有春天的感觉。我的技术写作职业生涯就此开启。 

第一年的工作内容和难点

2010年3月开始实习，4月底拿到毕业证正式入职。次年2月，我的组长兼工作导师调离她的岗位，毕业工作不满一年的我替代了她的岗位。这以后的事我打算在后面文章中再跟大家说。这篇的关键词是入门，我打算只说到工作第一年。

工作内容

这不满一年的时间里，前5个月的时间，我的工作是在给我的导师打下手，主要工作内容包括如下几点。

文档校对：通读她写完的文档，提出疑问或指出错误。

插图处理：用matlab，visio，photoshop，AI，CorelDRAW等软件为她写的文档处理配图。

文档翻译：翻译她写的文档。

文档撰写：在她所负责的项目中分几个功能模块由我负责撰写。

文档维护：一些已经交付的文档的更新。

后5个多月的时间，我主要独自完成一个项目的文档，同时负责一些老文档的维护。

工作难点

虽然相比较于技术研发，这是一份技术含量相对较低的工作。但是，工作之初，我依然感受到了巨大的挑战。在不到一年的时间里，我接触到了文档开发的各个环节的工作、几乎所有日后需要用到的图文编辑软件以及7大产品线几十个型号的产品。

且不说各种图文工具的操作和文档开发各环节要注意的琐碎的事项。

于我来说，难度和挑战最大的是对产品的理解。这一点尤其体现在不是个人独立承担项目的时候。今天这个产品做一点，明天那个产品做一点，每个产品都来不及了解。对于精密仪器仪表项目，每一个产品要弄清楚的功能点，原理，应用等，都如同一片大海。我当时就好似从一片大海到另一片大海之间频繁跳跃，每一片海都不停留。就在这种频繁跳跃中，我时常会感到茫然失措。

而对产品的全面深入认识对于写好文档至关重要。就如同人物传记作者对自己要写的那个人物要全方位深入了解，记者对自己要报道的事件要全面了解一样。不够了解产品，如同始终漂浮在水面之上，写文档的时候就会有“巧妇难为无米之炊”的无奈感。

然而，也正是第一年的“全轰炸式锻炼+ALL IN式投入”，使得我对整个公司的产品架构有了宏观的认识，对文档开发各个环节以及后来几乎所有用得到的工具都至少有了一面之缘。而这一切起码为即将到来的更大的挑战奠定了基础。

当我回头整理那段回忆的时候，脑海里浮现一张张熟悉而又亲切的脸。特别感谢他们，尤其感谢我第一位职场导师董丽萍，与我一同入门一同成长相互扶持的王美娜，还有许多直接或间接影响我的优秀的朋友们。未完待续……敬请期待下一篇文章《技术写作职业入门经验谈》

---

作者的自我介绍:叶子，85后工科女汉纸，2岁女孩的妈妈，做了7年技术写手，正尝试突破写作的边界！