技术写作人员

✍ dations ◷ 2025-03-04 20:16:12 #技术写作人员

技术写作人员 (Technical Writer) 是专业的信息传播者。他们通过最便于传递和理解信息的媒介,在两方或多方间传递信息或知识。这些信息的类型包括在线帮助、手册、白皮书、设计规格书、项目计划、软件测试计划等。随着在线学习 (E-learning) 的发展,越来越多的技术写作人员投入到创建在线培训资料的工作中。

以下是 Society for Technical Communication (STC) 对技术写作的解释:

技术写作有时被定义为“将复杂的东西简单化”。在这个简短且看似简单的定义中,所包含的是各种各样的技能和特性,在某种程度上几乎涉及到人类活动的所有领域。作为技术传播领域中的一个重要分支,技术写作涉及将复杂的信息传达给那些需要它来完成某个任务或目标的人。

换言之,技术写作人员将先进的技术概念以尽可能明确、准确、全面的方式传达给目标读者,并确保这些信息易于用户获取。

Kurt Vonnegut 将技术写作人员描述为:

...trained to reveal almost nothing about themselves in their writing. This makes them freaks in the world of writers, since almost all of the other ink-stained wretches in that world reveal a lot about themselves to the reader.

工程师、科学家、以及其他专业人员也可能参与技术写作(策划编辑、校对等),但通常会雇佣专业的技术写作人员来开发和编辑资料、设计版面、并建议最佳的信息发布方式。

根据 Society for Technical Communication (STC),技术传播和技术写作职业大约在第二次世界大战时期被首次提及,当时技术文档由于军事目的而成为必要。技术写作职位名称于第二次世界大战期间在美国出现,即使直到 1951 年才发布了第一则“Help Wanted: Technical Writer”招聘广告。事实上,直到 2010 年“Technical Writer”职位名称才被加入到美国劳工统计局的《职业前景手册》(Occupational Outlook Handbook)。20 世纪 40 到 50 年代,技术传播人员和写作人员受雇为军方编写文档,通常包括新型武器的详细使用说明。还有些技术传播人员和写作人员为当时出现的新技术编写文档。根据 O'Hara 的描述:

战争是科学和技术进步最重要的推动力。U.S. Army Medical Corps 在巴拿马的丛林里跟疟疾作战、Chemical Corps 推动了炸药和有毒气体(以及对它们的防护)领域的化学进步、Manhattan District of the Corps of Engineers 对物理学的理解有了巨大飞跃、Air Corps 成为航空设计的先驱。

在技术写作职业发展的初期,大多数技术写作人员跟写作团队一起在办公室工作。跟现在的技术写作人员一样,他们开展一手资料搜集,并与主题专家面谈以确保信息的准确。在第二次世界大战期间,能够遵从政府对于文档的严格规范是技术写作人员最重要的特征之一。二战后,随着新技术的兴起(如计算机),技术写作人员开始进入其它领域工作,编写用户手册、快速参考指南、硬件安装手册、和速查手册。在二战后的一段时期(1953-1961),技术传播人员(包括技术写作人员)变得热衷于使领域“专业化”。据 Malone 所述,为了使领域专业化,技术传播人员和写作人员实行了一系列举措:创建专业组织、形成一套专业的知识体系、推行技术传播从业人员的道德标准、关于从业人员资格认证的讨论、着手领域内教育项目的授权。

技术写作职业不断发展壮大。据 O'Hara 所述,写作和编辑职业(包括技术写作人员)的职位数量在 1994 到 2005 年间增长了 22%。当今技术写作人员的工作环境多种多样。很多技术写作人员使用 VPN 远程工作,或通过在线门户网站(如 Skype、Zoom)跟团队沟通。有些技术写作人员在办公室工作,通过可在线存储文档的内容管理系统跟团队共享内容。技术写作人员的工作内容涵盖了编写政府报告、内部文档、技术设备的使用说明、软件或系统的嵌入式帮助、或其它技术文档。技术的不断发展将为技术写作人员不断拓展更多的可能性。很多技术写作人员负责为移动应用程序和 Web 应用程序编写技术文档或嵌入式帮助文档。他们还编写仅用于在手持式设备上阅读的内容,然而其中大部分作品不会像过去的技术文档一样被印刷成册。

除了要有扎实的调研、文案写作、语言、写作、和校订技能外,技术写作人员可能还具备以下方面的技能:

技术写作人员也可以将这些技能应用到非技术内容的撰写。技术写作人员通常不是领域专家 (SME),他们通过与 SME 面谈和开展必要的调研来确保编写和收集的内容在技术上是准确的。为了能充分理解主题,技术写作人员需完成一手资料和二手资料收集。

一个专业的技术写作人员能够以简洁、有效的方式编写、理解、和传达技术信息。他们可能专注于某个特定领域,但必须对所描写的产品非常了解。例如,API 文档写作人员主要编写 API 文档,别的技术写作人员则可能擅长电子商务、制造业、科学、或医学资料。

技术写作人员从多个来源收集信息。他们的信息来源通常散布在组织的各个部门,可以从开发人员到市场营销部门。

根据 Markel 的观点,好的技术文档可以用 8 个特征来衡量:真实、清晰、准确、全面、易于访问、简洁、看起来专业、正确。技术写作人员致力于通过仔细研究使文档符合这 8 个特征。

要创建有效的技术文档,写作人员必须对这三个元素进行分析:读者、目的、和使用场景。这些元素之后就是文档设计,它决定了读者所看到的内容。

技术写作人员力求将复杂的概念或过程简化,使读者能最大程度地理解这些内容。文档的最终目标是帮助读者找到他们需要的内容、理解这些内容、并恰当地使用这些内容。要实现这个目标,技术写作人员必须了解读者是如何使用和阅读文档的。在一个文档项目开始时进行读者分析,有助于明确读者对某一特定文档的需求。

进行读者分析时,技术写作人员通常会提出以下问题:

通过准确的读者分析能够获得一套准则,用来决定文档的内容、设计和呈现形式(在线帮助、交互式网站、手册等)、以及语气和知识水平。

技术写作人员通过分析信息的目的或功能来了解文档须达成的目标。通过确定信息的目的(例如旨在说服读者“以某种方式思考或行动、使他们能够完成某项任务、帮助他们理解某事物、改变他们的态度”),来指导写作人员如何设计版面、以及选择哪种文档类型(在线帮助、白皮书、建议书等)。

使用场景是指读者使用信息时所处的物理和时间环境,例如:在他们的办公桌前、在某个工厂里、在生意不景气的夏季、或公司正处于危机当中。了解使用场景让技术写作人员知道读者如何使用这些信息。这些知识将会对写作人员设计信息的版面产生重大影响。例如,如果文档是关于一艘小型船舶的故障快速处理指南,写作人员可能采用页面覆膜工艺以增加使用寿命。

收集完以上信息,文档具有最佳的可读性和可用性。根据某专家的观点,技术写作人员使用 6 大策略来设计和编写技术内容:布局、重点、清晰、简洁、风格、和可信度。

技术写作人员有多种职位名称,包括 technical writer、technical communicator、information developer、technical content developer、technical documentation specialist。在 United Kingdom 和其他一些国家,技术写作人员通常被称为 technical author 或 knowledge author。

技术写作人员通常同时具备技术背景和写作技能。他们通常拥有某个技术领域的学位,但可能还具备新闻写作、商务或其它领域的学位。许多技术写作人员是从别的领域(例如新闻写作或技术领域)转行做技术写作的,通常在他们参加技术传播(technical communication)相关课程、学习到所需技能后。

在开始撰写技术文档之前,技术写作人员必须理解文档的主题、目标、和读者。他们通过学习现有资料、与 SME 面谈、以及实际使用产品来收集信息。他们对读者进行研究,以了解他们的需求和对技术的理解水平。

技术出版物的开发生命周期通常包含 5 个阶段,与产品开发计划相一致:

文档开发生命周期通常包含 6 个阶段(各个组织可能有所不同)。

这与软件开发生命周期相似。

好的技术文档通常遵循一套正式的标准或规范。技术文档具有多种风格和形式,取决于传播媒介和主题领域。印刷和在线文档虽然在许多方面不同,但在文字、信息结构、和布局上仍遵循基本相同的规范。技术写作人员通常遵循某个标准风格指南中的格式约定。在美国,技术写作人员通常遵循 The Associated Press Stylebook 或 the Chicago Manual of Style (CMS)。许多公司都有企业内部的风格指南,其中涵盖了企业标识的使用、品牌推广、以及企业风格的其他方面。Microsoft Manual of Style for Technical Publications 是这些风格指南中的典型代表。

工程类项目,特别是国防和航天相关项目,通常遵循国家和国际文档标准,例如针对民航机的 ATA100,或针对民用和军事防御平台的 S1000D。

技术写作人员通常是某个写作团队或项目开发团队中的一员。通常情况下,写作人员在完成初稿后,将其提交给一个或多个 SME 进行技术审核,以验证内容准确性和完整性。可能会由另一名写作人员或编辑人员进行编辑审核,以检查风格遵从、语法、和可读性等。在某些情况下,写作人员或其他人会请读者来测试文档,以改进文档可用性。文档的最终发布通常需遵照检查清单,以确保发布作品的质量和一致性。

对于技术写作人员来说,没有一个标准的职业通道,但他们中的部分人可能进入项目管理领域。有些写作人员可能晋升到高级技术写作人员的职位,处理复杂的项目或带领一个由写作人员和编辑人员组成的小团队。在大型组织中,一个 documentation manager 可能同时管理多个项目和团队。

技术写作人员还可能在获得某个特定技术领域的专业知识后,转行到相关的职业,例如软件质量分析或业务分析。有些技术写作人员在成为某领域的主题专家 (SME) 后,可能会转型到该领域工作。技术写作人员通常编写相关技术的培训资料,包括课堂指南和在线学习 (e-learning),其中某些技术写作人员转型成为职业培训师 (Professional Trainer) 和教学设计师 (Instructional Designer)。

具有写作技巧专业知识的技术写作人员能进入印刷媒体或电子媒体公司,从而获得赚取更多收入或改善工作条件的潜在机会。

美国劳工部 (U.S Department of Labor) 预计从 2016 到 2026 年技术写作人员的雇佣人数将增长 11%,略高于所有职业的平均增长率。他们预期工作机会是相当不错的,尤其是对于具备技术技能的申请者。美国劳工统计局还指出,“科学和技术产品”的发展以及“基于 Web 的产品支持”对技术写作人员的需求将刺激需求量的增长。 

相关

  • 男性荷尔蒙雄激素(英语:androgen、英语:androgenic hormones或英语:testoids),也译为雄性激素、男性激素、男性荷尔蒙,是一种化学成合物的泛称。在于脊椎动物中,凡是能够与雄激素受体(androgen
  • 希腊菜希腊饮食(希腊语:Ελληνική Κουζίνα)为典型的地中海风格,受意大利、巴尔干诸国、土耳其等国影响。广泛使用橄榄油、蔬菜、香草、谷物,以及面包、酒、鱼,各种肉类,包
  • 新货币的引入地产抵押马克又称为地租马克 (Rentenmark) ,是于1923年11月在德国推出的货币,用以遏制当时的恶性通货膨胀。它取代了因通货膨胀而一文不值的纸马克 (Papiermark),但只是作为暂
  • 鸠山邦夫鸠山邦夫(1948年9月13日-2016年6月21日),日本政治家,东京都人,东京大学法学部毕业。曾是日本自民党的实力派人物,曾任众议院议员、总务大臣、文部大臣、劳动大臣及法务大臣。鸠山邦
  • 清野菜名清野菜名(日语:清野 菜名/せいの なな  */?;1994年10月14日-),日本女演员、平面模特儿。爱知县稻泽市出身,毕业于日本艺术高等学园(日语:日本芸術高等学園),身高160公分,经纪公司为STI
  • 伊萨萨山坐标:42°9′48″N 2°8′47″W / 42.16333°N 2.14639°W / 42.16333; -2.14639伊萨萨山(西班牙语:Peña Isasa),是西班牙的山峰,位于该国北部拉里奥哈自治区,属于伊比利亚山脉中
  • 绥化府绥化府,清朝时设置的府。光绪三十年(1904年)升绥化厅置,治所在今黑龙江省绥化市。辖境约相当今绥化市、庆安县、铁力市等地。1913年降为绥化县。
  • 阿那克萨图斯(阿布德拉)阿那克萨图斯(阿布德拉)(英语:Anaxarchus),(前380年-前320年)。哲学家,德谟克利特的追随者,皮朗之师,曾陪伴亚历山大大帝远征亚洲,后被塞浦路斯王子奈克索里昂处死。
  • 1968年黑人权力致敬事件1968年奥运会黑人权力致敬事件是非洲裔美国运动员汤米·史密斯(Tommie Smith)和约翰·卡洛斯(英语:John Carlos)(John Carlos)在墨西哥城奥林匹克体育场举行的1968年夏季奥运会颁奖仪式上所进行的政治示威。史密斯和卡洛斯分别在田径200米的比赛获得金牌和铜牌后,他们在领奖台上面向他们的国旗,当听到美国国歌时,两个运动员举起戴着黑手套的拳头,直到国歌结束。此外,史密斯,卡洛斯和澳大利亚银牌得主彼得·诺曼都穿着有人权徽章的夹克。史密斯在他的自传《沉默的姿态》中表示,这一姿态不
  • 反恐24小时 (游戏)《反恐24小时》()是改编自福克斯电视连续剧《24》的第三人称射击游戏。游戏由索尼电脑娱乐的康桥工作室开发,2K Games于PlayStation 2平台发行。游戏消息于2005年3月30日公布,2006年2月27日在北美首发。玩家在游戏中不同地点控制来自连续剧的不同角色。游戏的任务使用了第三人称射击、驾驶和益智游戏元素。游戏配乐由肖恩·卡勒里谱曲,剧本由Duppy Demetrius和连续剧制作团队编写。《反恐24小时》广泛使用了电视连续剧中演员的配音和相貌,此外还有同一制作团队的剧本和乐谱。《反恐2