标准简介
本标准规定了两方面内容: a) 过程标准,规定用户文档的编制过程; b) 文档产品标准,规定对用户文档结构和信息内容的要求。 本标准的第5章~第9章规定了用户文档设计者和***的文档编制过程。包括:建立用户需要的信息、确定信息呈现给用户的方式、准备信息并使信息可用。这一过程不限于生存周期的设计与开发阶段,还包括贯穿信息管理和文档编制过程的活动。 第10章和第11章规定了对用户文档的结构和信息内容的要求。适用于软件系统用户在工作环境中使用的印刷文档和屏显文档,包括印刷的用户手册、在线帮助、教程和用户参考文档。 附录A 给出了适用于英文版本的用户文档的呈现格式,附录B、附录C、附录D分别提供了用户文档检查表、要求条款和文档编制过程检查表以及要求条款和文档产品的检查表。 尽管本标准未覆盖以下类型文档的所有方面,但对于其开发可能有所帮助: a) 除软件以外的产品的文档; b) 使用了动画、视频、音频的多媒体系统; c) 基于计算机的培训(CBT)包和正规的培训大纲中使用的专业课程材料; d) 为安装人员、计算机操作人员或系统管理员等制作而不是为*终用户制作的文档; e) 描述系统软件内部操作的维护文档; f) 并入用户界面的文档。 本标准适用于文档的设计者和***,包括多种专家: a) 对文档产品在文档集中的结构和格式进行规划的信息设计师和架构师; b) 确定预期用户将用软件执行的任务的易用性专家和商业分析师; c) 开发和编辑用户文档书面内容的人员; d) 具备电子媒体专业知识的平面设计师; e) 共同设计文档在屏幕上的呈现形式的用户界面设计师和人类工效学专家。 本标准还可供文档编制过程中的其他角色和利益相关方查阅: a) 软件开发过程或文档编制过程的管理人员; b) 阅读由供方编制的文档的需方; c) 易用性测试人员、文档评审人员和领域专家; d) 屏显文档创建工具的***; e) 确定原则使文档更易于理解和易于使用的人为因素专家。英文名称：Systems and software engineering—Requirements for designers and developers of user documentation
标准状态：现行
中标分类：电子元器件与信息技术>>信息处理技术>>L77软件工程
ICS分类：信息技术、办公机械设备>>35.080软件开发和系统文件
发布部门：国家质量监督检验检疫.
发布日期：2015-12-31
实施日期：2016-07-01
出版日期：2016-07-01
页数：88页【胶订-大印张】
前言
本标准按照GB/T1.1—2009给出的规则起草。本标准使用重新起草法修改采用ISO/IEC26514:2008《系统与软件工程用户文档的设计者和***要求》(英文版)。本标准与ISO/IEC26514:2008的技术性差异如下:———将ISO/IEC26514:2008的第12章移至附录A,作为资料性附录。———删除了ISO/IEC26514:2008的附录A、附录B和附录C。———删除了ISO/IEC26514:2008的附录D。———删除了ISO/IEC26514:2008正文部分有关英语语言习惯的内容及格式的要求及相关示例。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。本标准起草单位:国家网络软件产品质量监督检验中心(济南)、中国电子技术标准化研究院、广州广软信息系统管理咨询有限公司、上海计算机软件技术开发中心。本标准主要起草人:杨福涛、黄姗姗、孟宪勇、张彬、张雪莉、袁肃蓉、刘新、蔡立志、刘振宇、胡芸。
