技术写作人员

✍ dations ◷ 2025-09-14 07:12:22 #技术写作人员

技术写作人员 (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 的产品支持”对技术写作人员的需求将刺激需求量的增长。 

相关

  • 维尔纳·海森堡维尔纳·海森伯(德语:Werner Heisenberg,1901年12月5日-1976年2月1日),德国物理学家,量子力学创始人之一,“哥本哈根学派”代表性人物。1933年,海森伯因为“创立量子力学以及由此导致
  • 利比亚绿色革命利比亚绿色革命是在1969年8月31日于卡扎菲领导的自由军官组织发动的一场革命。革命直接导致利比亚王国被推翻,卡扎菲成为利比亚的最高领导人。1969年1月初,卡扎菲向策划革命的
  • 朱尼厄斯·理查德·贾亚瓦尔德纳朱尼厄斯·理查德·贾亚瓦尔德纳(英语:Junius Richard Jayawardene,僧伽罗语:ජුනියස් රිචඩ් ජයවර්ධන,泰米尔语:ஜூனியஸ் ரிச்சட் ஜயவர்தன
  • 陈贞慧 (明末)陈贞慧(1604年-1656年),字定生,中国江苏宜兴人,明末清初散文家。长子陈维崧为清代文人,四子陈宗石为侯方域女婿。父陈于廷是东林党人。陈贞慧是复社成员,文章风采,著名于时,与冒襄、侯
  • 没玩没了《没玩没了》(英语:)是全能制作公司制作、中国电视公司监制及首播的大型游戏节目,制作人为王钧、徐乃麟,主持人为徐乃麟、康康、曾国城、庹宗康、李懿,因各主持人空档录影时间并不
  • 吴谦 (歙县)吴谦(?-?),字六吉,安徽省徽州府歙县人,清朝著名医家。其祖吴凤以务农为业。吴谦精通医术,尤以伤科见长,与喻昌、张璐齐名。官至太医院判,供奉内廷。乾隆中,敕编医书,命谦及同官刘裕铎为总
  • 2011年3月9日三陆近海地震 除特别注明外,本文所有时间均以东九区时间(UTC+9)为准。2011年3月9日三陆近海地震是指2011年3月9日发生于日本本州岛太平洋近海的强烈地震。该次地震震中位于三陆近海(北纬38.
  • 维克托·金吉谢普维克托·爱德华·金吉谢普(Viktor Eduard Kingissepp 1888年3月24日-1922年5月4日),爱沙尼亚共产主义政治家,爱沙尼亚共产党领导人,在圣彼得堡组织建立了俄国社会民主工党爱沙尼亚支部,1917年二月革命后加入布尔什维克和赤卫队。十月革命时担任爱沙尼亚革命苏维埃副主席,德军占领塔林后逃往彼得格勒。期间加入契卡,1918年8月参与逮捕了范妮·卡普兰。12月回到爱沙尼亚组织爱沙尼亚共产党并主持了1920年10月首届代表大会。1922年5月3日因五一节游行被爱沙尼亚政治警察逮捕后处
  • 阿里嘎盖阿里嘎盖(阿美语:Alikakay;撒奇莱雅语:Alikakay),或译为阿哩嘎盖、阿里卡该、阿里嘎该,是流传于台湾阿美族与撒奇莱雅族的巨人异族传说。根据记载,阿里嘎盖族人皮肤白皙、碧眼如猫、金发长而多毛、身高达丈余(约三米多)。他们不仅跑的跟风一样快,还会使用法术,可以变身,或者用自己的毛变出士兵,就算身体的部位断了,也可以把树木接在断面上并变成新的身体。阿里嘎盖族仅5人:乎夫乎夫(Hofhof)、达贵(Takuy)、阿拉府各斯(Alafukes / Arakakay)、都厄兹(Doec)、巴都安(Pa
  • 金鹰勋章金鹰勋章(哈萨克语:Алтын Қыран ордені,罗马化:,俄语:Орден Золотого орла)是哈萨克斯坦共和国最高级别的勋章。。链章星章绶章副章50坚戈背面50坚戈背面