标准编号：ISO/IEC 26514:2008
中文名称：系统和软件工程 用户文件的设计者和开发者的要求
英文名称：Systems and software engineering — Requirements for designers and developers of user documentation
发布日期：2008-06
标准范围
This clause presents the scope, purpose, organization, and candidate uses of this International Standard.This International Standard supports the interest of software users in consistent, complete, accurate, andusable documentation. It includes both approaches to standardization: a) process standards, which specifythe way in which documentation products are to be developed; and b) documentation product standards,which specify the characteristics and functional requirements of the documentation.The first part of this International Standard covers the user documentation process for designers anddevelopers of documentation. It describes how to establish what information users need, how to determine theway in which that information should be presented to the users, and how to prepare the information and makeit available. It is not limited to the design and development phase of the life cycle, but includes activitiesthroughout the information management and documentation processes.The second part of this International Standard provides minimum requirements for the structure, informationcontent, and format of user documentation, including both printed and on-screen documents used in the workenvironment by users of systems containing software. It applies to printed user manuals, online help, tutorials,and user reference documentation.This International Standard neither encourages nor discourages the use of either printed or electronic (on-screen) media for documentation, or of particular documentation development or management tools ormethodologies.This International Standard may be helpful for developing the following types of documentation, although itdoes not cover all aspects of them:~ documentation of products other than software;~ multimedia systems using animation, video, and sound;~ computer-based training (CBT) packages and specialized course materials intended primarily for use informal training programs;~ documentation produced for installers, computer operators, or system administrators who are not endusers;~ maintenance documentation describing the internal operation of systems software;~ documentation incorporated into the user interface itself.specialists:~ information designers and architects who plan the structure and format of documentation products in adocumentation set;~ usability specialists and business analysts who identify the tasks that the intended users wdl perform withthe software:~ those who develop and edit the written content for user documentation;~ graphic designers with expertise in electronic media;~ user interface designers and ergonomics experts working together to design the presentation of thedocumentation on the screen.This International Standard may also be consulted by those with other roles and interests in thedocumentation process:~ managers of the software development process or the documentation process;~ acquirers of documentation prepared by suppliers;~ usability testers, documentation reviewers, subject-matter experts;~ developers of tools for creating on-screen documentation;~ human-factors experts who identify principles for making documentation more accessible and easily used.This International Standard is intended for use in all types of organizations, whether or not a dedicateddocumentation department is present, and may be used as a basis for local standards and procedures.Readers are assumed to have experience or knowledge of software development or documentationdevelopment processes.Users of this International Standard should adopt a style manual for use within their own organizations tocomplement the guidance provided in the annexes to this International Standard, or adopt an industry-recognized style guide. Annex A provides guidance for the content of a style guide, and Annexes B and Cprovide guidance on style.
立即下载标准文件