产品使用手册写作规范

《用户手册》写作规范一编写原则1基本原则面向初、中级用户，语言风格应简炼、通俗。不用不常见的形容词、名词等，避免语句过长（尤其是定语过长）。以循序渐进为原则，力求逻辑清楚、用词准确，同时也要注意写作内容的完整。2注意事项在手册中，应写明操作流程，包括整个系统的操作流程，以及每个功能的操作流程。举例应‘多’而‘精’。多指应尽量多为用户提供一些解决方案，将每个功能的各种处理通过举例来说明；精指每个例子的数据量不必太大，例如录入一张发票，有2-3条记录即可。手册中所举的例子应能前后联系。主要例子应同演示数据一致，例如，销售系统中的发货单、出库单、发票、以及帐表应能前后对应；应收系统中的应收单、收款单、帐表应能前后对应。各手册中所引用的公用目录信息应一致（见系统管理手册）。在每一部的结尾，都增加一个‘现在该往何处去’的说明，以说明到目前为止，用户已经做了哪些工作，下一步该怎样做。二格式规范目录规范第Ｘ部ＺＺＺＺＺ............................X第Ｘ章ＺＺＺＺＺ............................Xx.xＺＺＺＺＺ............................Xx.x.xＺＺＺＺＺ....................Xx.x.x.xＺＺＺＺＺＺ............X............x.x.x.xＺＺＺＺＺＺ............Xx.x.xＺＺＺＺＺ....................X.............x.xＺＺＺＺＺ............................X第Ｘ章ＺＺＺＺＺ............................X第Ｘ部ＺＺＺＺＺ.............................X.......2标题符号规范‘■’大项说明——用于无先后次序的明细条目的说明‘◆’小项说明——用于在大项下的无先后次序的小项说明‘●’提醒说明——用于在要诀、提醒、警告等文字中的分项说明‘N=1、2…’——操作步骤以阿拉伯数字以表明次序‘X=（1）、（2）…’——每步操作步骤的小步骤【例X-N】——举例，按章编号。例3-1、例3-2….技术细节——这个图标提醒你，这段讨论还是跳过去为好要诀——这个图标提醒你，就要有捷径或其它与论题有关的有用线索了。提醒——这个图标提醒你，如果你想把事情做得好些，就要牢记这些信息。警告——如果你想避免灾难，就要牢记这些信息。菜单项用【XXX】表示。例如【采购入库单】图标用〖XXX〗表示。例如〖增加〗快捷键用[XXX]表示。例如[Ctrl+B]界面中的字段和项目用“XXX”引用。例如“余额方向”选择框3插图表规范表格按章编号表XX-1表XX-2...表XX-N图按章编号图XX-1图XX-2..图XX-N图表编号放在图表正下居中4页面格式章与节间空两行；节与节间空二行；节与本节内容间空一行；两表(图)间空二行；其它节内内容间空行不得超过一行章、节、小节顶头写录入文字时，左侧起始处一律不要加入空格，各级标题及正文间层次通过<格式>菜单中<段落>的<左缩进>功能完成；也可直接用鼠标移动横标尺上缩进标记进行设置。一级标题（篇）、二级标题（章）、三级标题（1.1）、四级标题（1.1.1）、五级标题（1.1.1.1）：位于距页面最左侧起始处0.5CM处（段落左缩进0.5CM）。……级标题、章节内标题（如1.）、正文：位于距页面最左侧起始处2.5CM处（段落左缩进2.5CM）。根据实际需要录入所需层次。在段落内不要加入硬回车，只在分段处使用硬回车。在全角状态下，输入中文及中文行中标点；半角状态下输入英文、数字及英文行中标点。注：数字中涉及到的分隔符、小数点用半角；图表连接符“－”用全角。5页眉规范左页页眉：XX页第X章XXXX右页页眉：第X部XXXXXX页6字体规范正文：细园体11号字距：标准行距：固定值18镑页面设置纸张选择：B5纸页边距：上—2.4CM，下—3.9CM，左—1CM，右—1CM页眉（与边界距离）：1.4CM页脚：0CM装订线：0.8CM其它为缺省值。8关于提醒的背景symbol74\f"Wingdings"\s11J、symbol37\f"Wingdings"\s11%、symbol77\f"Wingdings"\s11M等引出的字段，要设置灰色的背景。【操作步骤】首先选中要设置背景的段落选中‘格式’菜单项下‘边框和底纹’选中‘底纹’页签。设置底纹浓度为25%9关于举例的序号问题：在正文段落中所举的很简短的小例子可以不必排序编号。用于说明操作事项或者比较复杂例子应该统一编号。三内容规范如何使用本手册本手册的内容结构——介绍手册的结构，以及用户该如何使用手册系统和手册中术语的解释——介绍手册中常用名词的基本概念本手册与系统管理手册关系第一部应用方案系统介绍系统功能产品接口如何使用本系统功能（应用解决方案）。。。。。--按不同的应用对象，类型，部门，范围提供方案，。。。系统操作流程—用流程图的形式介绍本系统的操作流程，并对每步骤加以说明新用户操作流程——介绍用户第一年使用本系统的操作步骤，从安装开始对每步操作及该步所用的模块加以说明，应按不同的应用方案，制定不同的操作流程，使用户完全能凭借手册提供的流程完成工作。老用户操作流程——主要介绍用户以后年度或升级使用本系统的操作流程，重点介绍新旧版或上下年之间的衔接，其它同上。。。。。应用准备—说明应用前应准备哪些工作，如哪些期初数据，哪些目录档案，分工等3．1XXX3．XXXX第二部应用操作系统初始。。。----按业务流程顺序介绍每个功能．。。。X系统选项X系统初始完整性检查XXXXX5．XXXXX——按业务流程顺序介绍每个功能。5．XXXXXXXX第x章XXXX第三部附录附录A图标操作一栏表附录BXXXXX版如何升级到本系统四模版1如何使用本手册编写模版参见帐务7。0手册阅读指南部分2每一部最后加：现在该往哪里去？XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX现列举《AC系统使用手册》中的该项说明，仅供大家参考：第一部后的说明：现在该往哪里去？如果您刚刚购买系统管理程序和应付帐款系统，请遵循‘系统管理使用手册’中的指南，把模块安装在您的计算机上。如果您已经安装了系统管理程序，可以按‘系统管理使用手册’中的指示，安装应付帐款系统。如果您已经安装了应付帐款系统，在您开始用自己的数据使用应付帐款系统之前，我们建议您读本手册的第二部‘系统的操作流程’和第三部‘使用前须知’。如果您准备好建立您自己的应付帐款系统时，请遵循本手册第四部‘使用入门’的指示。第二部后的说明：现在该往哪里去？如果您已经熟悉了系统的操作流程，在您开始用自己的数据使用应付帐款系统之前，我们建议您读本手册的第三部‘使用前须知’。如果您不熟悉系统管理程序的操作方式，您应该阅读‘系统管理使用手册’。第三部后的说明：现在该往哪里去？如果您准备好建立您自己的应付帐款系统时，请遵循本手册第四部‘使用入门’的指示。如果您不熟悉系统管理程序的操作方式，您应该阅读‘系统管理使用手册’。第四部后的说明：现在该往哪里去？现在，您已经掌握了本系统的使用方法。3使用操作模版第Ｘ章（或X.X）ＸＸＸＸＸＸXXXXXXXXXXXX本章（节）概述（模块操作的业务意义，完成的主要功能等）XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX【(本章（节）主要画面)或(操作流程)】（如没有可不写）X.X（或X.X.X）ＸＸＸＸＸＸＸＸXXXXXXX模块操作的业务意义，完成的主要功能说明XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX【本节（小节）主要画面或操作流程】（如没有可不写）【各栏目说明】（如没有可不写）XXXX:XXXXXXXXXXXXXXX:XXXXXXXXXXX【操作步骤】/【操作方法】（不能分出步骤的写为操作方法）用操作方法时以下可用如何XXX（例：如何开一新发票然后再按操作步骤写）1.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX[①.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx][画面][表格][②.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx][画面][表格]2.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX[画面][表格]注意XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX