ISO/IEC/IEEE 26512:2018 システムおよびソフトウェアエンジニアリング—ユーザー向けの情報の取得者および提供者に対する要件 | ページ 6

※一部、英文及び仏文を自動翻訳した日本語訳を使用しています。

3 用語と定義

このドキュメントの目的上、ISO/IEC/IEEE 24765 ( www.computer.org/sevocab で入手可能) および以下の用語と定義が適用されます。

ISO, IEC, および IEEE は、標準化に使用する用語データベースを次のアドレスで維持しています。

  • IEEE 標準辞書オンライン: http://dictionary.ieee.org で入手可能

3.1

アクセシビリティ

最も幅広い能力を持つ人々によるソフトウェアまたは情報製品、サービス、環境、または施設の使いやすさ

注記 1: 「アクセシビリティ」は通常、障害のあるユーザーを対象としていますが、この概念は障害の問題に限定されません。

[出典: ISO/IEC 26514:2008, 修正、項目の注 2 は項目の注 1 になり、項目の元の注 1 は削除されました。]

3.2

分析

ユーザーのタイプとその情報ニーズを特定することを目的とした開発の調査および収集段階

[出典:ISO/IEC/IEEE 24765:2010]

3.3

観客

同じまたは類似の特性やニーズを共有するユーザーのカテゴリ (情報を使用する理由、タスク、教育レベル、能力、トレーニング、経験など)

注記 1:情報のコンテンツ、構造、および用途を決定するユーザー (管理、データ入力、保守など) には、さまざまな対象者が存在する可能性があります。

[出典:ISO/IEC 26514:2008, エントリの注記 1 が修正され、編集上改訂されました:「意図された文書」は「情報」になりました。]

3.4

変更管理手順

開発中のソフトウェアまたは情報製品の変更を特定、文書化、レビュー、承認するために取られる措置

注記 1: この手順は、変更の妥当性を確認し、他の項目への影響を検査し、開発関係者に変更を通知するのに役立ちます。

[出典:ISO/IEC 26514:2008, 修正、編集上修正されたエントリへの注 ]

3.5

構成管理

以下に対して技術的および管理上の指示と監視を適用する規律。
  • 構成アイテムの機能的および物理的特性を特定して文書化します。
  • それらの特性の変化を制御します。
  • 変更処理と実装ステータスを記録および報告する。そして
  • 指定された要件への準拠を確認します。

3.6

契約

取得者と供給者の間の関係。大まかに言うと、一方の当事者が定義された商品およびサービスを提供し、他方の当事者がそれらに対して定義された料金を支払うことを規定します。

注記 1:多くの国では、契約を書面で作成する必要はありませんが、この文書で参照される契約の条件は書面で定義されます。

注記 2: 契約関係には、 「合意」などの別の名前が付けられる場合があります。この文書の適用においてどの用語を使用するかは取得者が決定します。

3.7

カスタマイズ

ソフトウェアまたは情報製品を特定の利用者のニーズに適応させること

[出典:ISO/IEC 26514:2008]

3.8

デザイン

ユーザーにどのような情報を製品で提供するか、また情報の性質を決定することに関係する情報開発の段階

[出典:ISO/IEC 26514:2008]

3.9

発達

ユーザー向けの情報を設計後に準備する活動

[出典:ISO/IEC 26514:2008]

3.10

書類

人間が使用するために一意に識別される情報単位

例:

印刷物または電子形式のレポート、仕様書、マニュアル、または書籍。

注記 1: 文書は、単一の情報項目であることも、より大きな情報項目の一部であることもあります。

[出典:ISO/IEC/IEEE 15289:2015]

3.11

ドキュメンテーション

製品の使用方法を説明する情報

注記 1:情報は、システムから独立して使用できる文書として提供することも、製品内に組み込まれて製品の不可欠な部分としてアクセスできることも、その両方として提供することもできます。本書では、「ユーザー向け情報」という用語は、「ドキュメント」および「ソフトウェア ユーザー マニュアル」という用語と同義です。他の形式のドキュメント (「システム ドキュメント」など) は、そのように明確に識別されます。

例:

印刷されたマニュアル、画面上の情報、スタンドアロンのオンライン ヘルプ、ビデオ、ポップアップ ヘルプ。

[出典: ISO/IEC 26514:2008, 修正、項目注 1 と項目注 2 を組み合わせて編集上改訂、項目注 3 は例となり、編集上改訂されています。]

3.12

テキストの本文とは別に設定され、通常は本文内で引用されるグラフィック要素

注記 1: 本書では、「イラスト」という用語は、表、図、展示物、画面キャプチャ、フローチャート、図、図面、アイコン、その他の種類のグラフィックの総称として使用されます。

[出典: ISO/IEC 26514:2008, 修正。定義には「グラフィック」の後に「要素」という単語が含まれるようになり、編集上改訂された項目への注 ]

3.13

国際化

国際的な視聴者に適した情報を開発するプロセス

注記 1: 3.14 ローカリゼーションを参照。

[出典:ISO/IEC 26514:2008, 修正、エントリに注 1 を追加。]

3.14

ローカリゼーション

製品の国または特定の地域バージョンの作成

注記 1: 3.13 国際化を参照。

注記 2: ローカリゼーションは、翻訳プロセスとは別に実行できます。

[出典: ISO/IEC 26514:2008, 修正、元の「cf」のエントリに注 1 を修正、エントリに注 2 を追加。]

3.15

画面上の情報

ソフトウェアの使用中にユーザーが画面上で読み取ることを目的とした情報

例:

ポップアップ ヘルプ、画面上のヘルプ テキスト。

[出典: ISO/IEC 26514:2008, 修正。用語は以前は「画面上のドキュメント」でしたが、以前のバージョンには「ドキュメント」が含まれていましたが、定義には「情報」が含まれるようになりました。注記 1 は編集上改訂され、例となっています。]

3.16

印刷されたドキュメント

印刷形式で提供されるドキュメント、または顧客またはユーザーが印刷できるように電子形式で提供されるドキュメント

[出典:ISO/IEC 26514:2008]

3.17

プロセス

入力を出力に変換する、相互に関連するまたは相互作用する一連のアクティビティ

[出典:ISO 9000:2005]

3.18

製品

プロセスの結果

[出典:ISO/IEC/IEEE 15288:2015]

3.19

製品の権威

製品の機能と品質に対して全体的な責任を負う人

[出典:ISO/IEC 26514:2008]

3.20

プロジェクト

新製品の開発または既存製品の強化のための一連の活動

[出典:ISO/IEC 26514:2008]

3.21

品質管理

品質に関して組織を指揮し、管理するための調整された活動

[出典:ISO/IEC/IEEE 15288:2015]

3.22

ソフトウェア

情報処理システムのプログラム、手順、規則、および関連文書の全部または一部

注記 1:この文書の目的上、「ソフトウェア」という用語には、画面上の文書は含まれません。

[出典:IEEE Std 828-2012]

3.23

スタイル

文法、用語、句読点、大文字の使用、単語の選択をカバーする、言語固有の編集規約のセット

[出典:ISO/IEC 26514:2008]

3.24

技術的な連絡先

情報開発者に製品に関する技術情報を提供する、またはユーザー向けの情報草稿の技術的正確性をチェックする責任者

注記 1:技術担当者は、多くの場合、対象分野の専門家としても知られています。

[出典: ISO/IEC 26514:2008, 修正、「情報開発者」を「文書開発者」に置き換え、「いわゆる対象分野の専門家」を削除、項目への注記 1 を追加。

3.25

トピック

単一の主題を扱う文書の小さな部分

注記 1:利用者向けの印刷情報では、トピックはセクション (見出し、小見出し) とその内容に相当します。画面上の情報では、トピックはタイトル (見出し) と主題に関する情報 (通常はタスク、概念、または参照情報) で構成されます。画面上の情報については、システムはユーザーの介入なしでトピックを表示する場合があります。

例:

現在のドキュメントを印刷する方法についての説明。

[出典: ISO/IEC 26514:2008, 修正済み、項目の注 1 には、編集上の変更を加えた以前の項目の注 2 の内容が含まれています (「画面上の情報」が「画面上のドキュメント」に置き換わります)項目の注 3 は、例。]

3.26

チュートリアル

ユーザーがシステム機能を実行するための指導手順。多くの場合、システムに付属するサンプル データやユーザー向けの情報が使用されます。

[出典:ISO/IEC 26514:2008]

3.27

使いやすさ

指定された使用状況において、有効性、効率性、満足度を伴って指定された目標を達成するために、指定されたユーザーがシステムまたは情報製品を使用できる程度

[出典:ISO/IEC 25064:2013]

3.28

ユーザー.ユーザー

自動システムを使用して 1 つ以上のタスクを実行する人。特定の聴衆のメンバー

[出典:ISO/IEC 25064:2013]

3.29

ユーザーインターフェース

ユーザーがシステムと対話できるようにするソフトウェアとハ​​ードウェアのアンサンブル

[出典:ISO/IEC 26514:2008]

参考文献

1カーネギー メロン大学CMMI for Acquisition (CMMI-ACQ) Primer, V1.3 、以下からダウンロード可能: www.sei.cmu.edu/reports/11tr010.pdf
2Hackos, JT Information Development: ドキュメント プロジェクト、ポートフォリオ、人材の管理。ニューヨーク: ジョン・ワイリー&サンズ、2006年
3IEEE Std 730™-2014, ソフトウェア品質保証プロセスの IEEE 標準
4IEEE Std 828™-2012, ソフトウェア構成管理計画の IEEE 標準
5ISO 9000:2015, 品質マネジメントシステム - 基礎と用語
6ISO/IEC/IEEE 15289:2015, システムおよびソフトウェアエンジニアリング - システムおよびソフトウェアのライフサイクルプロセス情報製品の内容 (ドキュメント)
7ISO/IEC TR 19759:2016, ソフトウェア エンジニアリング — ソフトウェア エンジニアリング知識体系ガイド (SWEBOK)
8ISO/IEC/IEEE 24765, システムおよびソフトウェア エンジニアリング - 語彙、 http://www.computer.org/sevocab を参照
9ISO/IEC 25062:2006, ソフトウェア エンジニアリング - ソフトウェア製品の品質要件および評価 (SQuaRE) - ユーザビリティ テスト レポート用の業界共通フォーマット (CIF)
10ISO/IEC/IEEE 26513, システムおよびソフトウェアエンジニアリング — ユーザー向け情報のテスターおよびレビュー担当者の要件
11ISO/IEC 26514:200, システムおよびソフトウェア エンジニアリング — ユーザー ドキュメントの設計者および開発者に対する要件
12ISO/IEC/IEEE 26531:2015, システムおよびソフトウェア エンジニアリング - 製品ライフサイクル、ユーザーおよびサービス管理のためのコンテンツ管理
13Rockley, A. 『エンタープライズ コンテンツの管理: 統一コンテンツ戦略』 、インディアナポリス: New Riders Press, 2003
14米国リハビリテーション法、第 508 条、 http://www.section508.gov/
15ISO/IEC 26511:2011 (IEEE Std 26511-2011)システムおよびソフトウェアエンジニアリング — ユーザードキュメントの管理者の要件

3 Terms and definitions

For the purposes of this document, the terms and definitions given in ISO/IEC/IEEE 24765 (available at www.computer.org/sevocab ) and the following apply.

ISO, IEC and IEEE maintain terminological databases for use in standardization at the following addresses:

  • IEEE Standards Dictionary Online: available at http://dictionary.ieee.org

3.1

accessibility

usability of a software or information product, service, environment, or facility by people with the widest range of capabilities

Note 1 to entry: Although “accessibility” typically addresses users who have disabilities, the concept is not limited to disability issues.

[SOURCE:ISO/IEC 26514:2008, Modified, Note 2 to entry has become Note 1 to entry, original Note 1 to entry has been deleted.]

3.2

analysis

investigation and collection phase of development that aims to specify types of users and their informational needs

[SOURCE:ISO/IEC/IEEE 24765:2010]

3.3

audience

category of users sharing the same or similar characteristics and needs (for example, reason for using the information, tasks, education level, abilities, training, experience)

Note 1 to entry: There can be different audiences for information for users (for example, management, data entry, maintenance) that determine the content, structure, and use of the information.

[SOURCE:ISO/IEC 26514:2008, Note 1 to entry modified and editorially revised:"intended documentation" has become"information."]

3.4

change control procedure

actions taken to identify, document, review, and authorize changes to a software or information product that is being developed

Note 1 to entry: The procedures help to ensure that the validity of changes is confirmed, that the effects on other items are examined, and that those people concerned with the development are notified of the changes.

[SOURCE:ISO/IEC 26514:2008, Modified, Note 1 to entry editorially revised.]

3.5

configuration management

discipline applying technical and administrative direction and surveillance to:
  • identify and document the functional and physical characteristics of a configuration item;
  • control changes to those characteristics;
  • record and report change processing and implementation status; and
  • verify compliance with specified requirements.

3.6

contract

relationship between acquirer and supplier, which in broad terms prescribes that one party will provide defined goods and services and the other party will pay a defined fee for them

Note 1 to entry: In many countries, contracts do not have to be written but the terms of the contracts referred to in this document are defined in writing.

Note 2 to entry: The contract relationship can have other names, such as “agreement.” The acquirer determines which term is to be used in the application of this document.

3.7

customization

adaptation of a software or information product to the needs of a particular audience

[SOURCE:ISO/IEC 26514:2008]

3.8

design

stage of information development that is concerned with determining what information for users will be provided in a product and what the nature of the information will be

[SOURCE:ISO/IEC 26514:2008]

3.9

development

activity of preparing information for users after it has been designed

[SOURCE:ISO/IEC 26514:2008]

3.10

document

uniquely identified unit of information for human use

EXAMPLE:

Report, specification, manual, or book in printed or electronic form.

Note 1 to entry: A document can be a single information item or part of a larger information item.

[SOURCE:ISO/IEC/IEEE 15289:2015]

3.11

documentation

information that explains how to use a product

Note 1 to entry: The information can be provided as documentation that can be used independently of the system or embedded within the product and accessible as an integral part of it, or both. In this document, the term"information for users” is synonymous with the terms “documentation” and “software user documentation.” Other forms of documentation (for example, “system documentation”) are clearly identified as such.

EXAMPLE:

Printed manuals, on-screen information, standalone online help, videos, pop-up help.

[SOURCE:ISO/IEC 26514:2008, Modified, Note 1 to entry combined with Note 2 to entry and editorially revised, Note 3 to entry has become an example and has been editorially revised.]

3.12

illustration

graphic element set apart from the main body of text and normally cited within the main text

Note 1 to entry: In this document, the term “illustration” is used as the generic term for tables, figures, exhibits, screen captures, flow charts, diagrams, drawings, icons, and other types of graphics.

[SOURCE:ISO/IEC 26514:2008, Modified, definition now includes the word"element," after"graphic" and Note 1 to entry editorially revised.]

3.13

internationalization

process of developing information so that it is suitable for an international audience

Note 1 to entry: See 3.14 localization.

[SOURCE:ISO/IEC 26514:2008, Modified, Note 1 to entry added.]

3.14

localization

creation of a national or specific regional version of a product

Note 1 to entry: See 3.13 internationalization.

Note 2 to entry: Localization can be performed separately from the translation process.

[SOURCE:ISO/IEC 26514:2008, Modified, Note 1 to entry modified original"cf", Note 2 to entry added.]

3.15

on-screen information

information that is intended to be read on the screen by the user while using software

EXAMPLE:

Pop-up help, help text on a screen.

[SOURCE:ISO/IEC 26514:2008, Modified, term was previously"on-screen documentation", definition now includes"information" while previous version included"documentation." Note 1 to entry has been editorially revised and has become an example.]

3.16

printed documentation

documentation that is either provided in printed form, or provided in electronic form for the customer or user to print

[SOURCE:ISO/IEC 26514:2008]

3.17

process

set of interrelated or interacting activities that transform inputs into outputs

[SOURCE:ISO 9000:2005]

3.18

product

result of a process

[SOURCE:ISO/IEC/IEEE 15288:2015]

3.19

product authority

person or persons with overall responsibility for the capabilities and quality of a product

[SOURCE:ISO/IEC 26514:2008]

3.20

project

set of activities for developing a new product or enhancing an existing product

[SOURCE:ISO/IEC 26514:2008]

3.21

quality management

coordinated activities to direct and control an organization with regard to quality

[SOURCE:ISO/IEC/IEEE 15288:2015]

3.22

software

all or part of the programs, procedures, rules, and associated documentation of an information processing system

Note 1 to entry: For the purposes of this document, the term “software” does not include on-screen documentation.

[SOURCE:IEEE Std 828-2012]

3.23

style

set of language-specific editorial conventions covering grammar, terminology, punctuation, capitalization, and word choice

[SOURCE:ISO/IEC 26514:2008]

3.24

technical contact

person responsible for providing an information developer with technical information about a product or for checking the technical accuracy of drafts of information for users

Note 1 to entry: Technical contacts are often also known as subject-matter experts.

[SOURCE:ISO/IEC 26514:2008, Modified,"information developer," replaced"documentation developer,""so-called subject matter expert" removed, and Note 1 to entry added.]

3.25

topic

small part of a document that deals with a single subject

Note 1 to entry: In printed information for users, a topic is equivalent to a section (heading, subheading) and its content. In on-screen information, a topic consists of a title (heading) and information about a subject (typically, a task or a concept or reference information). For on-screen information, the system might present a topic without user intervention.

EXAMPLE:

Instructions on how to print the current document.

[SOURCE:ISO/IEC 26514:2008, Modified, Note 1 to entry includes content of previous Note 2 to entry with editorial modifications ("on-screen information" replaces"on-screen documentation"), Note 3 to entry has become an example.]

3.26

tutorial

instructional procedure in which the user exercises system functions, often using sample data that is supplied with the system or information for users

[SOURCE:ISO/IEC 26514:2008]

3.27

usability

extent to which a system or information product can be used by specified users to achieve specified goals with effectiveness, efficiency, and satisfaction in a specified context of use

[SOURCE:ISO/IEC 25064:2013]

3.28

user

person who performs one or more tasks with an automated system; a member of a specific audience

[SOURCE:ISO/IEC 25064:2013]

3.29

user interface

ensemble of software and hardware that allows a user to interact with a system

[SOURCE:ISO/IEC 26514:2008]

Bibliography

1Carnegie Mellon University CMMI for Acquisition (CMMI-ACQ) Primer, V1.3, Available as a download from: www.sei.cmu.edu/reports/11tr010.pdf
2Hackos, J.T. Information Development: Managing your Documentation Projects, Portfolio, and People. New York: John Wiley & Sons, 2006
3IEEE Std 730™-2014, IEEE Standard for Software Quality Assurance Processes
4IEEE Std 828™-2012, IEEE Standard for Software Configuration Management Plans
5ISO 9000:2015, Quality management systems — Fundamentals and vocabulary
6ISO/IEC/IEEE 15289:2015, Systems and software engineering — Content of systems and software life cycle process information products (Documentation)
7ISO/IEC TR 19759:2016, Software Engineering — Guide to the Software Engineering Body of Knowledge (SWEBOK)
8ISO/IEC/IEEE 24765, Systems and software engineering — Vocabulary, see http://www.computer.org/sevocab
9ISO/IEC 25062:2006, Software engineering — Software product Quality Requirements and Evaluation (SQuaRE) - Common Industry Format (CIF) for usability test reports
10ISO/IEC/IEEE 26513, Systems and software engineering — Requirements for testers and reviewers of information for users
11ISO/IEC 26514:2008 (IEEE Std 26514-2010), Systems and software engineering — Requirements for designers and developers of user documentation
12ISO/IEC/IEEE 26531:2015, Systems and software engineering — Content management for product life-cycle, user and service management
13Rockley, A. Managing Enterprise Content: A Unified Content Strategy, Indianapolis: New Riders Press, 2003
14U.S. Rehabilitation Act, Section 508, http://www.section508.gov/
15ISO/IEC 26511:2011 (IEEE Std 26511-2011) Systems and software engineering — Requirements for managers of user documentation