本文主要是介绍开发者必知 制作标准用户手册的15条技巧，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
用户手册声称可解决问题，但实际上不仅不能提供帮助，反而让你愈加迷惑，这种情形你多久会遇到一次呢？如果你是一个典型的用户，这种情形可能会经常发生。设计得如此糟糕的内容会让用户产生不满与沮丧情绪，对产品质量留下不良印象；而且还会(对出售产品的公司来说)增加售后服务时间与成本。于是智能文本管理应运而生。智能文本管理理解终端用户的行为，并在多数可能的实际行为中与用户需求保持一致。在本文中，我将提供一些实际技巧，帮助你建立合适、易懂、可读性强的用户手册。
了解你的读者
了解手册的读者是谁，读者需要了解什么内容。这样你就可以决定手册内容的深度与广度，以及编写手册应使用何种语言(例如，针对专家与初学者的语言与内容都有所不同)。关键在于只提供用户需要的信息——不多也不少。
采用面向任务的方法
多数产品的功能体现在允许用户实现特殊的任务。采取面向任务的方法，根据应用产品能够执行的任务来安排手册内容。例如，如果产品帮助你配置网络，你的手册目录应包含这样的标题，如“建立一个网络”、“配置网络设置”及“删除网络”。
确保信息流程合乎逻辑
仔细研究一下产品，以循序渐进的方式了解先做什么、接着做什么、最后做什么。这样做可以大大改进文件信息的易读性。
应用模块
把信息分解成易于管理的小块，每个部分解释一个特定的用途或主题。这样的小块让读者阅读起来很轻松，各部分的思路也很清晰。模块式的写作方式易于维护，并可通过内部链接实现信息再利用。
应用目录
目录可帮助我们了解手册的整体内容。保证手册内容全面、结构完整、并拥有一个模块化的布局。这种方法可帮助用户方便找到他们所需要的信息。
应用有意义的一致标签
清晰且提供信息的标签可帮助用户快速而正确的找到信息。避免使用一般的标签标题，标签应简明扼要。
以交谈式的语调书写
采用常见问答(FAQ)的编写方法。这种方法允许你轻而易举地缩短用户与产品之间的差距，并提供许多用户需要的通用信息。
仔细考虑重要信息的位置
首先查看页面或屏幕的中部，然后是左上角，是人类的本性。尽量将材料的重点内容安排在布局的物理中心附近，并将主标题安排在左上角。
应用适当的插图
令人惊奇的是，人们往往低估了图片在文本中的作用。外观吸引人的文本总能发挥更大的作用。插图(图例、表格、工艺流程图)是手册内容的主要组成部分，它不但能吸引读者的注意力，还可强化阅读效果。
尽可能将信息制成表格
表格可改善信息的可读性。在需要根据不同的基础描述对象，或在不同的维度间比较对象时，可应用表格。
提供实例
用类推、实例或个案研究来证明你的概念与说明。实例有助于用户迅速掌握概念，并更好地理解其内容。
包含解决问题的提示
在为程序作注解时，分析可能的失败情形并告诉用户如何处理发生的问题。如果你有一本独立的解决问题的手册，指导用户去那里寻找更多的信息。
建立很好的索引
人们通常认为，如果材料设计很糟糕的话，用户就会在索引中寻找所需的信息。在索引中通过重要的关键词来包含基本信息，以方便信息恢复。
编辑与审核
对材料进行编辑，保证它遵守完整性、语言、拼写与语法、连贯性与格式方面的规则。
执行“现实检查”
确保对材料与产品进行协同测试，以揭示书面材料与现实应用之间的差异。对揭示的差异进行纠正，并重复测试过程，保证在纠正过程中不会出现新错误。
顾客支持
记住，用户手册的主要目的在于提高用户的生产效率，减少顾客支持时间、成本与努力。优质的材料可作为新用户的培训材料，以及返回用户的支持材料。遵守上述指导方针可保证信息的访问性与可用性，减少支持时间，提高顾客满意度。
这篇关于开发者必知 制作标准用户手册的15条技巧的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
