最新消息:想上头条?没问题,只要你给本站投稿就行啦~

技术文档工程师的典型一天

原创 ChinaTechWriting 2947浏览 0评论

如果你还没成为一枚技术文档工程师,那么,在很大程度上,你只能从网上的各种文章来想象这份工作的典型一天。互联网上有写博客的同行以国外居多,国内很少,因此,你所了解的Technical Writer工作情景,并不一定与国内实际完全相符。不信?请接着往下看。

你以为你的典型一天会这样度过:

1. 早晨九点上班,先花上半小时看看科技新闻,虎嗅,爱范儿什么的,各种互联网思维,令人眼界大开。

2. 慢悠悠地泡了杯茶,喝完之后,开始和团队写作成员召开例会,总结昨天的写作成果,并为今天定下写作目标。Team Leader很优雅地在白板上写下各种要点,还不忘带上标点符号,Nice~

3. 上午十点开始,你总算正式开工了。根据安排,你为昨天研发部添加的某个New Feature写了一小节的说明,然后抄送给写作团队成员Review。

4. 在等待其他人给你反馈时,你抽空看了一下客服部门上周总结的问题列表,从中发现自己负责的某部分手册内容写得不够清晰,于是决定改进一下。你发邮件给对应的客服,咨询其对某个问题的见解,发现确实是手册的问题,遂动手改之并Commit到SVN版本库中。

5. 部门老大发了封邮件出来,指出某位同事在对某个功能的描述中,用词不是很贴切,让大家讨论下。本来有点安静的办公区内,顿时热闹了起来,你一言我一语的,大伙儿纷纷从语法、用户情景等各种角度提出自己的见解。最后,讨论在欢快祥和的气氛中圆满结束,和往常一样,老大一锤定音。

6. 午饭时间,也是扯淡的好时间。话题转为国外Technical Writing的最新趋势,期间必然伴随着对国内TW届的各种怒其不争之感慨。

7. 午休完毕,你刷了一下微博,呃,可怜的汪峰,又没能上头条。

8. 刷完微博,开始今天的下半场吧!此时已经是下午两点。

9. 研发部门要求你们老大派人出席他们的一个需求研讨会,方便文档部门对产品研发来龙去脉有个大致的把握,如对文档写作日程做出预估。你自告奋勇,老大看你手头暂时也没其他事,便派你去参加会议了。

10. 半个钟就能解决的会议,也不知道为啥研发这帮家伙能够扯到一个钟,各种技术路线什么的,虽然你也听不太懂,不过还是觉得很厉害的样子。

11. 参加完会议回来,已经是下午三点。你发现早上自己更新的文档已经有人做出反馈了。根据对方的意见,适当调整了一下措辞。

12. 研发部又提交了一个Change Request,并在Demo环境中实现了该变更,好吧,你也只能继续跟上,对手册进行更新。

13. 下午四点,有点困,起来走走,顺便再泡杯茶。

14. 你反复翻看现有的用户手册,总觉得还是有不完善的地方。动手改了几个标点符号,把几个段落调整一下后,长舒了一口气,这下总算完美了。没办法,谁叫你是处女座呢,对吧。

15. 隔壁同事问你某个功能如何操作,你试了一下,也不清楚。于是你跑去找对应的工程师,咨询了一下,最终搞清楚这个功能的正确操作步骤。你还顺便请教了一下这个功能的设计出发点,工程师都一一予以解答,你感觉很满意,收获也很大。你坚信,Technical Writer不应该仅仅了解产品如何用,还要懂得产品背后的设计动机,体验人性的深处。只有这样,你才能写出超一流的使用说明。

16. 似乎是时候写写今天的工作报告了。

17. 下午六点,发完工作报告后,准时下班。路过研发办公区时,程序猿们投来各种羡慕嫉妒恨的眼光。你微微一笑,飘然而去,深藏功与名。

怎么样,上面这些工作情景,是不是想想都有点小激动呢?先别激动啊,也许,事实上会是另外一幅情景呢,尤其是当你只是一个小公司的Lone Writer时:

1. 写手册写到一半,工程师前来索要Word版的使用手册,说是客户要求的。这都什么跟什么啊,PDF不是国际标准嘛,况且公司也只提供CHM和PDF格式手册,为毛总有客户无理要求啊!没法子,只能手动编辑一份呗。

2. 市场部同事丢过来一份文档,说麻烦给翻译成英文,急着用。好吧,开始翻译ing……

3. 商务部MM发了个邮件,说麻烦看下合同排版是否合适,并帮忙加个目录和页码……

4. 老板转发了一个方案建议书,让你给润色一下,因为售前工程师写出来的东西根本就不是给人看的……

5. HR负责人在QQ上和你聊了一下,说过两天有个新员工入职,希望你准备下PPT什么的,到时候给新人讲解一下公司的产品。

6. 客服跑来问某个功能有没有具体的手册说明,当然有啊,你们咋都不看手册的!于是你把对应手册截取出来后邮件发给对方。

7. 你研究某个功能,怎么也想不明白如何用,于是发邮件给开发。等了半天,对方才回复说这个是定制的功能,你使用的版本用不了这个功能。混蛋,定制功能为毛做到标准版上来啊?当然啦,这只是你心里的想法,万万是不能直接说出来的,不然以后就不能愉快地和开发交流了。

8. 技术支持部门负责人笑嘻嘻地过来问,明天有空不?我们工程师都外出了,明天有个客户培训任务,要不你顶上去?看着对方满是期盼的眼光,你只好答应了。

9. 呃,忙了一整天,好像一开始写的文档都还没完成呢,咋办?凉拌呗,明天再说吧……

以上内容,请大家自行脑补,谢谢!

不同行业,不同公司的技术文档工程师,工作情景也不尽相同,此外国内外的差别也是不小的。不知道看完这篇文章的你,又有什么感想呢?欢迎踊跃评论。


原创文章,版权归作者所有,转载请注明本站以及作者名称,并保留原文链接

本文链接:http://www.chinatechwriting.com/typical-day-for-a-technical-writer/


The following two tabs change content below.
ChinaTechWriting
中国技术文档写作资讯网官方账号
ChinaTechWriting

Latest posts by ChinaTechWriting (see all)

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (4)

  1. 后一段工作情景描写得很是贴合实际情况,五年来的生活基本上就是这么过来的
    TWD4年前 (2015-01-06)回复
  2. 朝着理想状态努力下,应该是可以实现的
    sunshine哪尼3年前 (2015-06-05)回复