【技术传播】结构化内容写作与内容管理方法论.pdf

跟用户进行自然、友好、高效和专业的沟通结构化内容写作与内容管理方法论目目录录认识技术传播（TC）1了解结构化写作2内容结构的设计3结构化写作的流程4多渠道多形式的技术内容5PART1认识技术传播什么是技术传播TC？技术传播也是一门专业热点事件：人教版数学教材插画引争议人教版小学数学教材插图引发社会广泛关注，对此，教育部表示，已责成人民教育出版社立即整改，并立即部署对全国中小学教材进行全面排查。网友发现，此版本教材插图人物眼神奇怪、毫无美感，甚至出现很多引发争议的内容。什么样的技术内容才最有价值？让我们一起看一个 Out of the Box 的手机说明书设计吧！https:/ Communication）是全球化产品重要的组成部分，也是产品营销的有利手段，涉及内容包括使用说明、技术资料、使用手册、宣传资料等。技术传播是伴随技术性产品、软件或服务全部生命周期所有技术信息的传递交互，它一方面是产品和服务不可或缺的技术说明文件，另一方面也是体现生产者的法律责任、技术能力、服务水平最直接的市场名片。无论是技术资料还是市场文档都同样承载着企业的品牌形象，体现着企业的专业能力和服务精神，是出使用户的“先行官”，若想在国际化竞争时代取得竞争优势，它的重要性不言而喻。技术文档质量不高，消费者会怀疑产品质量，公司品牌也会受损，甚至造成订单流失。2014年“中国高铁海外失利”，投标文案或是一个重要因素，相信这类事件的发生，会触发一些人的反思和行动，认识到技术写作的重要性。高质量文档与产品高销售正相关高质量文档和产品高销售的正相关特性才能真正体现产品文档是产品的一部分，文档的价值就能体现产品本身的价值。技术传播是一门专业美国美国美国有100多所大学有技术传播或者技术写作相关的专业或者课程，在美国共有290多个技术传播专业，技术传播也成为价值上千亿美元的一项产业，该行业的专业人才需求越来越旺盛，政府每年都要与工业企业签订大量采购合同，技术传播者充当着研究、生产、管理和客户间联系人的角色。西方从业者非常多，IBM、微软、思科及爱立信等大公司都要很强大的技术写作团队。只要涉及科学与技术领域的公司，一般都有专职的技术写作人员。中国中国在中国技术传播还处于起步阶段，但中国有大量的企业已经意识到技术传播的重要性，其中包括中国最大的信息技术企业华为、中兴、联想等，都设置了专门的技术传播部门。技术写作的历史指导如何完成日常的仪式关于中药、疾病预防和治疗的手册世界第一部关于农业和手工业生产的综合性著作第二次工业革命催生高科技产业复杂精密仪器、药品、计算机软硬件技术传播成为一种必要技术传播行业发展2016年1月发布的中国企业语言服务市场调查显示（图1），除笔译、口译需求之外，技术写作已成为第三大主要需求2015年中国企业语言服务统计技术传播行业分布TC行业人员构成在以上文档工程师中，近80%者是通过自学走上了技术传播的职业生涯。这一数字则反映出我国技术传播教育的严重缺位。目前我国从事技术传播的文档工程师，近60%来自理工科背景，近30%为外语背景技术传播行业发展的八个趋势 技术信息传播行业的最新趋势之一，结构化文档内容复用、同源开发、多渠道发布等是其他便捷操作的基础 国际化大型机构将结构化文档视为削减开支的方式，然而要做到文档的结构化需要大量的工作 国际机构通过应用结构化文档来减低多语种翻译的成本结构化文档的应用允许同一内容在多个文档中应用，这意味着写作者也不确定某个信息块将出现在哪个位置。向消费者提供多个相关文档已成为趋势，如技术手册、帮助系统、知识库、电子学习内容等它可以实现同一内容的多次利用，并按要求自动生成同源开发随着多媒体设备及电子产品的逐渐渗透，出版方通过多种格式对内容进行多渠道出版PDF逐渐成为转换信息的工具，多渠道输出不仅是为纸质使用说明提供电子版本印刷物、PDF、EPUB、HTML、CHM等多格式、多渠道输出用户希望可以随时随地获取信息响应式页面设计通过HTML设置适合移动设备的屏幕尺寸，这项技术可根据不同的移动设备提供多种的版面布局及图像。移动输出的应用更倾向于利用搜索引擎来寻找答案这样的方式搜索起来更简单，效率也更高可以根据上下文语境提供用户帮助，为用户在有限的时间内提供快速解决方案主题式内容及情境感知帮助消费者逐渐由文字交流转向多媒体交流，即音频、图像、动画、视频、交互式内容等学习资料中应用视频和动画来辅助用户理解，已经成为行业发展的趋势多媒体通信技术写作者不只是产品信息看门人的角色，而应为自己所写的信息负责社交网络达人帮助企业宣传产品信息，并对反馈意见进行评估内容聚合器收集社区意见，并对客户意见提出解决办法社交网络智能内容是未来的一个趋势，智能帮助系统能追踪用户的使用习惯，甚至能感知用户的使用场景在用户遇到问题时推送相关信息，或者自动排除故障，用户甚至都不知道自己遇到了问题未来，随着物联网的普及，智能帮助系统能够获取更多信息，从而更好地为用户提供帮助。智能内容一个好的技术写作，能够与用户进行自然的、友好的、高效的和专业的沟通。华为给咱爸妈的冬日暖心礼物支付宝给咱爸妈的冬日暖心礼物要想让内容发挥价值，应该将内容当作一个产品来考虑把用户关心的信息，以用户易懂易获取的方式进行写作排版，最终呈现给用户，这都需要设计，只是太少人以设计的思路看待内容。技术写作的目的沙发看书场景安装儿童推车场景选购手机场景商场寻找卫生间场景为了带来乐趣，打发时光，增长见识，开拓视野。手机的参数说明了解参数的意义说明书摊开拿着工具边看边做寻找指示牌告诉你几楼和位置快速找到信息，完成特定任务高效地帮助读者（或称用户）完成特定的任务技术写作的目的 帮助用户理解一个产品和服务的详细概念、流程等信息 比如：可以用的电脑参数、用什么电源，某种药物的成分、适应症，办理护照要提交什么材料。概念解释 帮助用户实现他需要完成的任务 比如，电脑如何开机，药物该如何服用，如何办理护照。任务指导技术内容与市场内容技术内容市场内容直接提供信息的干货说服消费者来 购买产品和服务功能不同客观具体表达，更加具体和平实语言漂亮、高大上、讲究创意、快来看我写作风格严格按标准写，风格指南和内容管理创意很重要，追求形式多变，会讲故事内容影响标准是否可用，易读、易获取消费者痛点，引起注意，产生共鸣，促进转化率评价标准渠道较少，随产品发布广撒网、付费渠道、自有渠道传播渠道不同用户角色、任务不同宽泛读者范围技术内容是市场内容的证据，为市场内容提供信任的理由，具体使用的技术是什么，性能参数怎么样。技术内容自身很多时候也承当了一定程度的“说服”的功效。设计良好的技术内容成就高效沟通 技术内容是基于事实的，不允许杜撰和夸大 技术内容是简洁的，高信噪比 技术写作面向特定的读者，并受使用场景的影响安装人员、使用人员、维修人员不同的手册 技术内容是可以“消失”的内容安装空调的熟练工已经记住了操作，不需要看手册互联网的原住民，从小接触电子产品 追求标准化追求一致，不追求写作的个性同一个组织或者公司的内容，应该是一样的风格技术内容“填补认知鸿沟”技术内容这个床是多大的，我们家的空间能否放下？安装的时候，有没有操作指导？运输的过程中，床板损坏了，我该怎么办？企业的误区忽略技术内容的价值而对其不管不问，反而会造成浪费没有任何管理，想省钱，结果反而花了更多钱没有找到很好的办法对技术内容进行创建管理，导致其作用得不到好的发挥。正确的组织、创建和使用技术内容能够解决很多的问题，节省成本，并提高效率。你想不到究竟有多少部门在重复地写这个内容？到底多少内容是真正传递出去了?没有一个整体的技术内容规划，导致大量重复劳动，发布大量的内容，不去考虑长期管理。技术内容的价值避免纠纷降低成本增强粘性技术内容能够避免售后产生的纠纷技术内容能够降低成本增加用户的体验，提高用户黏度，助力塑造企业和组织的口碑错误的技术内容引起的严重后果2011年5月，葛兰素史克感冒药因说明书错误在港澳被召回（儿童服用剂量标错，比正常高出一倍）2010年斯巴鲁BRZ跑车召回事件（用户手册对安全气囊描述不恰当）沃尔沃汽车2010年召回事件（C30车主手册关于天窗功能操作的内容缺失，使用者对操作及安全防范措施不了解）苹果电脑由于没有用户手册导致诉讼（苹果中国公司没有对iphone6plus提供免费的中文使用手册）淘宝客服沟通，自动回复常见问题的解答自助服务APP、AI、AR，推送内容的形式解决问题产品介绍，市场部、研发部、服务部、支持部各写一遍，彼此不知情，哪怕知道，也认为自己写得好多部门不同人创建除了导致成本高昂，容易导致不一致问题，不同渠道传播，不一致内容导致用户对企业信任危机。在产品售后对用户提供正确的可用的指导可以的大大提升用户的满意度什么样的技术内容才是最有价值?技术内容要可用，要从用户的问题中来 技术内容要可复用，减少不必要的重复劳动 技术内容自身应该简洁，并在结构、风格、语言的选择上应该具有一致性 好的技术内容是好管理的技术内容 技术内容需要多渠道发布什么样的技术内容才是最有价值？42%44%69%36%数据来源：sharonburton调查报告客户对产品文档的感受如果产品的文档不好，产品的质量也不会高文档不完整、信息不准确等问题，他们会没有信心使用产品说明书文档比较差，说明该公司或组织根本不关心用户用户会对此感到非常生气。此外，产品的价格越贵，用户对产品资料的期望就越高！跨界的技术写作：教父母使用微信实际的指导意义、引起用户的情感共鸣、让用户感到舒适，增加与用户之间的情感联结PART2了解结构化写作认识什么是结构？结构化写作是什么？什么是结构和结构化写作？结构化：结构化的过程就是将一堆杂乱的事物理清楚的过程，能够很清晰地帮你确定是什么（定义），有什么（组织），放在哪（分类和整理）的问题。把你凌乱不堪的衣橱，按照衬衣、裤子、袜子、内衣、春秋季、冬季、夏季等分类方法整理，最终整理成整洁有序的样子。结构化写作：结构化写作就是对你的内容进行定义，组织，分类和整理的过程。结构化写作设计的本质是逻辑和常识，它是将零散的信息，数据，内容等用一种框架收拢起来，设计出一个个能够被用户理解的内容模块。内容的结构 内容的结构就是指内容的模块在一个发布物中呈现的层级和顺序。一本书的最基本结构：封面、内容章节、封底。让我们抓狂的杂乱无章让人心情愉悦的整齐划一内容的结构以结构化的思路进行写作，会使你的文档看起来不会杂乱无章，每一部分都紧密联系，形成一个整体。结构化写作的特征满足具体用户的需求，从用户的角度出发。功夫花在前期的结构规划，具体写作的过程是填空的过程。基于标准化的写作。写作对象是内容模块，将大段文字切割成内容模块，而不是一个大文档。对作者有严格的写作约束，如针对内容的创建，定义，结构和属性等任何方面的规则。结构化写作设计的本质是逻辑和常识，它是将零散的信息、数据、内容等用一种框架收拢起来，设计出一个个能够被用户理解的内容模块！为什么要采用结构化的内容写作和管理？线性阅读非线性阅读既定的文字和图像从前到后从上到下稳定性强阅读心理稳定思索指向稳定数字时代与非线性阅读传统的阅读方式用户的关注时间短信息之间的互相依赖需要降低直接从中间看到你需要的信息提升阅读的效率内容模块可以组合，发布成不同的文档结构化写作的适用情景需要高效率的沟通需要管理大量的信息多人协作，内容可能被交换或整合内容需要被复用内容不需要过多的创造和创意适用的：会议纪要工作计划简历.不适用：小说广告文案一首诗歌写作应该是科学逻辑和艺术美感的结合，有时候结构甚至会对美感也会有所助力。结构化写作与本地化翻译对于任何面向国际市场的企业来说，翻译的费用都是非常昂贵的。结构良好的技术内容对本地化翻译的费用能够大量地减少。考虑到产品的全球同步发布，建立一个从技术内容的产生、创建、到多语言翻译的端到端全流程是非常必要的。提高本地化翻译的复用率简单明了的原则，减少了不必要的内容模块冗余的文字结构化写作提升翻译的效率技术作者要发展，需要掌握的相关能力 要具备进行结构化思考的能力。熟练掌握用户分析和研究的能力。根据公司的商业目标，用户群体特征，深入了解产品和领域知识，制定公司的内容战略。把握行业动态与领先技术，研究内容管理与信息设计的方法论，业界最佳实践等。根据内容战略，商业目标以及用户需求，进行内容架构的设计和资料定义。主导公司级别内容管理平台的规划，设计与部署，技术内容整体发布渠道的规划。领导公司级别的内容制度建设以及流程的优化。给出公司统一的产品本地化翻译策略。PART3内容结构的设计内容模块、内容元素转换思路：看待内容的方式写作等同于文档，将文档等同于Word结构化写作的思路：看到文档内容的逻辑和骨骼，也就是结构！不要在意最后是否几百页文档发布，更不要以此来评估和衡量工作成果！要关注内容本身，内容是否出现在合适的地方，是否得到了最大程度的使用和复用，用户是否愿意去阅读，是否真的给用户解决了问题，给产品和服务带来好处。内容的机构层级文档体系内容模块内容元素整个产品和服务的信息架构包含哪些交付物即哪些文档？每个交付物的结构即一个发布物包含哪些内容模块？亦即文档中包含什么内容模块。内容模块的内部结构即一个内容模块中包含哪些内容元素。内容与模块中包含什么元素？TCaaS与TCaaP TechnicalContentasaService 使用技术内容服务 促进用户的自助服务，节省成本 比如，指导手册的参数说明，减少很多技术支持的电话TCaaS 技术内容看作一个产品 许多产品的技术内容跟产品一起发布，是产品的一部分 把内容当作一个产品来设计非常重要TCaaP我们本可以被更多人支持 研发部门：希望产品的客户满意度更高。服务部门：希望减少因为简单的问题带来的电话和工单。市场部门：希望有内容作为证据来支持他们的广告内容。大多数人不是没有发现问题，而是还不知道很多问题原来可以通过高效的技术传播来解决。依靠技术写作和技术传播我们是为他们输出资料结构化的思维方法结构化就是从混乱到清晰的一个过程由大到小、由高到低，由整体到部分推导和演绎的过程自上而下的结构设计以内容模块出发，再发展到复杂和完整的体系进行大量的信息搜集工作自下而上的结构设计相互独立，完全穷尽时间结构（流程、逻辑关系、依赖关系）、空间结构（并列关系、包含关系）MECE法则是什么、为什么、在哪里、什么时间、什么人、如何做七步分析法5W2H把握核心内容优先的原则二八定律UPC+M设计有效的技术内容UPC+M用户、产品、竞争管理U以用户为中心的写作：用户的研究、分析，用户成长旅程，不同的文档需求P产品和服务：技术写作因为产品和服务而存在，要依托于产品C参考你的同行竞争对手：行业的习惯、行业的标准内容结构M要有管理内容的思路：标准、绩效、存取、流程、渠道PART4结构化写作的流程写作流程、用户研究方法、内容模型、内容标准结构化写作的流程是怎样的？用户研究的方法用户访谈焦点小组问卷调查用户测试已有用户的反馈虚拟用户应用场景用户访谈设计开放性问题：完整性、一致性、可用性、便携性什么是“伪需求”？有时候用户给你反馈的需求，并不是他真正需要的，这就要我们挖掘出用户真正想要的。举个例子：a)你是通过什么途径了解这个产品的？b)你最常用的操作是什么？c)你完成这个任务需要什么信息？d)完成任务的过程会让你觉得烦躁和挫败吗？焦点小组组织者尽量地“置身事外”，只做一个观察者。对于技术内容焦点小组的观察，不应是观察用户对技术内容的使用，而是观察用户对产品的使用，对服务的使用，或信息查找的方式。用户困惑的原因、提出的问题，就应该是你的提示信息、你的主要参数说明、以及手册的内容。问卷调查 问题设计要容易回答，问题不要过多。不要用预设的答案引导用户。用户测试任何设计不经过用户测试就谈不上以用户为中心。测试不是测试用户对内容的使用，而是将内容放入更大的语境，测试其是否能够满足用户的需求。技术写作无法脱离产品和服务，否则再漂亮的内容，再有逻辑的写作，也都只是“花架子”，无法真正帮助用户完成任务。已有的用户的反馈 电话客服 技术支持 一线销售 百度,Google,Bing虚拟用户 姓名 年龄 教育背景 兴趣爱好 痛点 为什么需要你的产品和服务 研究现有内容情况1.确认现有的文档类型以及内容模块有多少种文档的类型？文档包含哪些内容？之间联系是如何的？不同文档类型的共性？是否有共同的内容模块？是否有内容缺失？2.确认内容是如何使用、复用和传递给不同的客户的各个文档都是谁负责？谁来管理？谁来使用？内容传递的形式有哪些？不同部门之间的内容是否有重合，有哪些重合？3.确认内容是否有重复创建同一个内容类型在不同部门多次创建本应是同种类型的内容却有不一样的结构内容内部模块有很大相似性的内容之间没有进行复用4.确认内容是否符合用户的需求该内容模块的存在是否有实际需求用户是否很容易获取到内容这些内容的格式是怎么样的。某软件产品的内容梳理技术内容与用户旅程的紧密结合用户旅程了解阶段考虑阶段转换阶段使用阶段拥护阶段用户的内容需求帮助我了解的细节需求（我可能只有个大概的想法）帮我了解你的品牌和产品给我解决现问题的建议了解产品和服务的价值得到详细的产品规格信息了解产品的易用性与竞争对手进行比较试用（可能的话）知晓ROI第三方认证信息了解其他客户的情况得到产品的支持信息对操作和使用的学习对今后使用的保证信息我想去分享我的心得和经验我需要得到反馈技术内容类型广告宣传类内容产品详细参数信息产品参数对比信息产品演示专题文章技术白皮书用户访谈用户案例专家分析测评用户评价信息产品安装、操作使用类信息保修内容产品升级信息社交媒体的分享UGC技术论坛运营测评与调查创建每个文档的内容模型定义：内容结构的抽象与固化就是内容模型。包含哪些内容模块，内容模块是内容的基础单元。独立性内聚性可复用性大小适中内容模块设计的原则内容模块可以单独被创建修改存储和维护，不影响其他内容模块一个内容模块只解决一个问题，模块变动不影响其他模块，耦合性低内容模块能够在多个内容体系使用，任何上下文通用过大内容模块等于没有结构划分；过小会局促，同样不清晰跨产品线的全内容模块对比内容模块A系列产品B系列产品产品简介产品简介安装说明安装说明硬件说明硬件说明应用场景概览应用场景概览使用说明如何完成功能a如何完成功能b如何完成功能c使用说明如何完成功能a如何完成功能b如何完成功能c常见问题解答常见问题解答产品设计方法论产品设计方法论内容模型抽象示例原文抽取关键信息内容结构化内容模块的两个视图What管理视图How内容模块Why用户视图管理视图：看到的是内容模块在后台存储的结构，是内容管理者看到的视图。用户视图：对用户最终的内容模块的组织形式和呈现。用户视图关注的是为什么和怎么做。用户视图和管理视图 对比管理视图配置TCP/IP配置网关配置DDNS配置QoS用户视图如何连接网络 配置TCP/IP 配置网关 配置DDNS如何进行网络通信的优化 配置QoS 结构化的内容定义产品规格说明的内容定义文档类型内容模块定义及属性内容元素定义及属性产品规格说明产品简介对产品进行简明扼要的介绍，包括产品是什么，有什么功能，什么时候使用产品定义短段落，最多两句话。描述产品是什么产品主要功能说明段落，列举功能点和关键技术产品使用场景段落（可含列表）描述产品的主要使用场景产品外观说明D产品的外观展示产品图片图片，产品的照片，或线框图，图片上产品应按照顺序加上数字标记产品部件说明列表或表格，将数字与部件名称进行对应。注：空间足够的情况下，可直接将部件名称标注在产品图片上。结构评审阶段完整性包含了应有的内容模块是否缺失内容可用性是否根据不同用户进行划分是否用户关注的内容一致性内容体系和结构是否一致不一致是为什么复用性复用是否合理内容是否过大或者过细结构化的内容评审评审方面权重关键指标得分正确性20%语言错误参数错误技术理解错误可用性30%步骤是否能完成用户任务标题是否能够帮助用户定位内容举例是否实用完整性20%功能介绍是否完整操作步骤是否有遗漏一致性10%术语是否一致功能名是否一致该复用的内容模块是否进行了复用简洁性10%是否有过长的段落是否有过多的修饰语清晰性10&结构是否清晰合理是否有模棱两可的语言结构标准化阶段标准化实质是一个一致的协议，标准化才能使结构的一致性和内容的交互与复用成为可能。标准化应遵循统一和简化的原则。统一原则：结构的统一和功能的统一。简化原则：保持整体构成精简合理，使之功能效率最高。简化的基本方法是剔除其中多余的、抵消的内容，精炼出高效能的能满足全面需要所必要的内容模块。简化的实质不是内容变得简单，而是变得精准练达。文档（内容）体系的标准化文档的标准化内容模块的标准化内容元素的标准化 什么样的产品需要什么样的内容体系 依据目标用户需求根据法律要求来制定 功能单元的内部结构 标准化的句子、段落、图片写作原则：避免“死线抽象”死线抽象（dead-level abstracting），是一个新闻语言学的概念。指语言的运用者只在语言抽象层次的某一级上使用语言，忽视各种事物的复杂局面，将表达该事物的语言固定于某一不变的抽象层次上。死线抽象的概念，来自于柯日布斯基的一个弟子温德尔约翰逊。所谓死线抽象，是指语言的运用者只在语言“抽象阶梯”的某一级上使用语言，忽视各种人群和事物的多样性、复杂性，把语言表达固守在某一类型、层次或水平线上，从而产生语言失当和不对称。普通语义学认为，有效的语言传播应当沿着抽象阶梯有上有下，不应死死钉在某一级上，不能都是同一种不变的风格，应当区别对象，富于变化，这样才能满足不同受众的需求。平行搭配。是指说话要分清对象，即如俗话所说：“到哪个坡唱哪个歌”，“见什么人说什么话（这里仅指方式，而非指圆滑）”；对文人说话要学会修饰、高雅；对体力劳动者说话要学会通俗、生动；对长者、上司等说话要更多地注重礼貌；对朋友说话则不必过于客套高位下倾。是指专业知识较丰富的人士，应当了解、熟悉和理解大众化的语言，善于将自己深奥的专业知识用通俗易懂的语言表达出来，也就是我们常说的要“深入浅出”、“大众化”。低位高攀。是指文化程度较低者，既要自信，又要努力学习各种基本的知识，并且力求理解消化，这样坚持不懈，日积月累，终究能很方便地跟那些文化程度较高的人士平行对话。异质互补。是指不同专业人士之间的对话和交流，不能总是固守在自己熟悉的专业角度说话，既不能一味地对非本专业人士说一些别人听不明白的专业术语。同样的意思、相近的含义，尽可能转换为相互都能理解的共同符号。这就要求各自多熟悉对方的语言符号和习惯。写作原则：米勒法则米勒法则，从心理学的角度来看，人类处理信息的能力是有限度的。根据米勒(Miller，1956)的分析，人脑处理信息有一个魔法数字7(正负2)的限制，也就是说，人的大脑最多同时处理5到9个信息(chunks)。原因是短期记忆储存空间的限制，超过9个信息团，将会使得大脑出现错误的概率大大提高。写作时，任何信息都尽量不要超过9个项目。如果超过9个项目的情况，可以对其进一步归类。例如写操作步骤的时候，有几十步骤才能完成，就需要对步骤进行一次概括和归类。长的段落比短的段落读起来要困难得多。技术内容的段落不要超过9句话，建议是一个主题句，加上四五个支持的句子。阅读需要注意力，大段的文字会吓跑读者，他们会直接略过不看，你想传递的信息目标就失败了。常见文档的内容结构和写作方法文档类型内容模块内容元素属性示例产品规格说明产品简介产品定义短段落，描述产是什么XX产品是一款家用指纹锁产品主要功能说明段落，列举功能点和关键技术XX产品具有U远程访问，设备管理，和权限管理的三个主要功能产品使用场景段落，（可含列表）描述产品的主要使用场景本系统通常应用于以下场景 森林防火 道路监控 矿井监控产品外观说明产品图片图片、产品的照片或线框图，图片上产品应按照顺序加上数字标记产品部件说明列表或表格，将数字与部件名称进行对应。注：空间足够的情况下，可直接将部件名称标注在产品图片上产品性能参数产品各项性能表现规格列表或表格，将性能分类并一一列举产品功能列表产品功能列表列表或表格，将性能分类并一一列举配件配件介绍配件图片并说明每个配件的名称操作说明的结构文档类型内容模块内容元素属性产品操作说明产品简介（可选）产品定义短段落，描述产品是什么产品主要功能说明段落，列举功能点和关键技术产品使用场景段落，（可含列表）描述产品的主要使用场景操作任务一操作目的短句子，对操作的目的进行说明操作前提操作前的准备，注意事项等。列表项或段落步骤介绍操作步骤，StepbyStep操作任务二操作目的对操作的目的进行说明操作前提操作前的准备，注意事项等。步骤介绍操作步骤，StepbyStepPART5多渠道多形式的技术内容技术内容渠道建设的重要性、从PGC到UGC从PGC到UGCPGCUGC专家或权威内容用户产生的内容内容传播从单向到双向，再到多向传播；用户在整个传播过程中的作用越来越大技术内容渠道1.随产品包装发布的纸质印刷品2.充分发挥官网的价值3.微信公众号（技术服务的公众号）4.淘宝等电商网站的产品详情页5.其他（二维码印刷）6.用户产生的内容（微信群、用户论坛）7.视频传播（短视频）最后：技术作者一定是多面手用户体验传播学计算机语言基础结构化思路文笔把握产品本地化