Technical Writer 不只是写产品说明书的

Foreword

2018 年 3 月 28 日的时候,我和 Queeny 一起回北京大学软件与微电子学院给在读的学弟学妹们做了一个分享

之后一个学妹找我咨询论文相关的事情,因为她写的论文是关于技术写作的。我根据自己从事技术写作的一些经验和积累的知识,回答了她几个问题。然后她跟我说,“一般的人都以为咱技术写作就是写说明书的,学姐有时间了可以专门写一篇推送”。

当别人让你解释 Technical Writer 是干嘛的时,回答说写说明书的或许可以让对方快速理解。但那只是一个方面而已,并不能涵盖 Technical Writer 的所有工作。

Technical Writer 可能遭遇的尴尬

你有没有遇到过不知该如何给别人解释清楚 Technical Writer 到底是做什么的尴尬境地?尤其是当父母或其他长辈们问起的时候……

说的多了吧,他们可能理解不了,也不想理解;说的少了吧,他们可能觉得你的工作就是干这么点儿事儿啊。最后想想,算了,佛系回答吧~

之前跟大家分享过两分钟趣味解读 Technical Writer 的一个小视频,还附上了一个 Technical Writer 怎么跟别人解释自己的工作的漫画版。

最近还在网上看到一个用 DITA 写技术文档的 Technical Communicator 跟别人解释自己工作的对话,好奇的小伙伴可以去看一下。地址:https://techwhirl.com/integrated-technical-communications-a-map-to-better-understanding/

你以为的不一定是真的

很多尚未进入或者刚刚进入 Technical Writer 这一行的小伙伴可能对技术写作的种类仍然存在认知偏差,认为技术写作就只是写产品说明书的。同时,对 Technical Writer 这一职业本身的认识也有待刷新。

或许,用另外一个表达可以在某种程度上减轻这种认知偏差,即 Technical Communicator。

业内对这类岗位的叫法不一,Technical Writer 是相对来讲比较普遍的叫法,中文叫法一般为“技术文档工程师”,也有叫 Information Developer 或 Content Strategist 的,这样听起来就高大上多了有木有~

另外,这个岗位在有些公司是设立在研发部门中的。

这里所说的技术写作的种类 (Technical Writing Categories) 即 Technical Writer 可提供的 deliverables 的种类。

在分工很细的大外企里,Technical Writer 或许只负责某个技术写作种类中特定部分的工作,轻易不会改变。相比之下,在其它企业尤其是创业公司里,Technical Writer 这个名称就完全不能涵盖实际承担的工作了,已不能从传统的认知去理解。

有的外企 Technical Writer 或许工作几年也只接触到一种类型而已;而在快速发展的技术型创业公司里,Technical Writer 就会快速接触到多种技术写作的类型,虽然承担的工作内容多了,但有利于个人快速成长。

Technical Writer 到底在写些什么文档

如果细数起来,Technical Writer 写的文档包括许多种类,这里先跟大家分享一些常见的,你如果进入 Technical Writer 这一行很可能会接触到的文档类型。如下所示:

  • User Guide
  • Administrator Guide
  • Troubleshooting
  • FAQs
  • How To Guide
  • Release Notes
  • Weekly
  • White Paper
  • Case Study
  • Knowledge Base Articles
  • Training Course Materials

只看上面这些词,或许有点一知半解。没关系,我会在稍后的文章中对这些文档类型做一个具体而直观的分享。

Afterword

时代在变化,行业和岗位也在变化,所以我们要经常地刷新一下自己的认知。

很好奇 Technical Writer 小伙伴们有没有这样的经历呀,觉得自己很机智地跟别人解释了自己的工作?

欢迎留言交流哦~

你可能想读

技术文档诞生记 | 完整的技术写作流程是怎样的?
Technical Writer 日常工作中好用的小工具
技术翻译需要有 Technical Writer 的 sense
深度解析关于技术翻译的六个认知误区
如何让你的内容输出更加专业更有设计感?
书单 | 有哪些技术传播从业者必知必看的书籍?
有哪些适合技术传播从业者关注的优质博客?(一)
有哪些适合技术传播从业者关注的优质博客?(二)
经验分享 | 来自 11 位 Technical Writer 前辈的职业发展建议(上篇)
经验分享 | 来自 11 位 Technical Writer 前辈的职业发展建议(下篇)
英语技术文档的标题到底该大写还是小写?
如何使用正则表达式批量添加和删除字符?
Markdown:写技术文档、个人博客和读书笔记都很好用的轻量级标记语言
如何为 Markdown 文件自动生成目录?
技术写作实例解析 | 简洁即是美
两分钟趣味解读 Technical Writer
若脱离理解,直译得再正确又有何意?
优质译文不应止于正确,还要 Well-Organized
写在入职技术型创业公司 PingCAP 一个月之后
揭秘 Technical Writer 的工作环境 | 加入 PingCAP 五个月的员工体验记

-END-

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容