ДСТУ ISO/IEC 26514:2015 Инженерия систем и программного обеспечения. Требования к дизайнерам и разработчикам документации пользователя (ISO/IEC 26514:2008, IDT)
ПІДТВЕРДЖУВАЛЬНЕ ПОВІДОМЛЕННЯ
Наказ
(ДП «УкрНДНЦ»)
від 05.11.2015 № 145
ISO/IEC 26514:2008
en: Systems and software engineering -- Requirements
for designers and developers of user
documentation
прийнято як національний стандарт
методом «підтвердження» за позначенням
ДСТУ ISO/IEC 26514:2015
uk: Інженерія систем і програмного забезпечення. Вимоги
до дизайнерів і розробників
документації користувача
(ISO/IEC 26514:2008, IDT)
З наданням чинності від 2016–01–01
Contents
Foreword
Introduction
1 Scope
2 Conformance
2.1 Application of conformance.
2.2 Conformance situations
3 Normative references
4 Terms and definitions
5 User documentation process within the systems/software life cycle
6 Project requirements, objectives, and constraints
6.1 Project objectives
6.2 User documentation requirements and constraints
6.3 Project goals and constraints
6.4 Users and usability objectives
6.5 Interviewing technical contacts and other experts
6.6 Project planning
6.7 Documentation proposal
7 Analysis and design
7.1 Audience and task analysis
7.2 User documentation design
8 Development and review
8.1 Prototypes and drafts
8.2 Evaluation of documentation
8.3 Documentation testing
9 Production
9.1 Final assembly and review
9.2 Approval
9.3 CM
9.4 Updating and maintenance
10 Structure of documentation
10.1 Overall structure of documentation
10.2 Structure of documentation according to audience needs
10.3 Size of topics in onscreen docu mentation
10.4 User documentation components
10.5 Placement of user documentation components
11 Information content of user documentation
11.1 Completeness of information
11.2 Accuracy of information
11.3 Content of identification data
11.4 Information for use of the documentation
11.5 Concept of operations
11.6 Information for general use of the software
11.7 Information for procedures and tutorials
11.8 Information on software commands
11.9 Explanations of data entry fields
11.10 Content of error messages and problem resolution
11.11 Content of warnings and cautions
11.12 Information on terminology
11.13 Information on related information sources.
11.14 User-supplied content
12 Presentation format of documentation
12.1 General
12.2 Use of printed or on-screen formats
12.3 Selection of appropriate media and format
12.4 Context-sensitive information
12.5 Accessible documentation
12.6 Consistency of formats
12.7 Consistency of terminology
12.8 Layout of screens and pages
12.9 Legibility
12.10 Formats for lists
12.11 Formats for representing user interface elements
12.12 Use of color
12.13 Navigational features
12.14 Documentation formats for finding information
12.15 Formats for warnings, cautions, and notes
12.16 Format for instructions
12.17 Formats for user-supplied annotations
12.18 Formats for illustrations
12.19 Icons and signposts
12.20 Documentation packaging
Annex A (informative) User documentation style guide content
Annex В (informative) Writing style and techniques for user documentation
Annex C (informative) User documentation style for translation and localization
Annex D (informative) Design, development, and production of printed information
Annex E (informative) Checklists for user documentation
Annex F (informative) Requirements clauses and checklist for the documentation process
Annex G (informative) Requirements clauses and checklist for documentation products
Bibliography
Полная версия документа доступна в тарифе «ВСЕ ВКЛЮЧЕНО».