この規格 プレビューページの目次
※一部、英文及び仏文を自動翻訳した日本語訳を使用しています。
導入
この文書は、ISO/IEC/IEEE 15288:2015 または ISO/IEC 12207 のユーザーがライフサイクル プロセスの一環として、ユーザーおよび情報サービスのためのシステムおよびソフトウェア情報を取得または提供できるようにするために作成されました。これは、取得者の観点と供給者の観点から情報開発プロセスを定義します。この文書は、取得および提供プロセスの一環として、ユーザー向け情報の識別、定義、要件の履行について説明します。
この文書は、ユーザーの情報を取得する際に使用される情報項目の要件 (取得計画、文書仕様、作業明細書、提案依頼書、および提案書) について説明します。また、取得および供給プロセスにおける文書計画の使用についても説明します。
この文書は、ユーザー向けの情報を作成するために使用できるソフトウェア ツールから独立しており、印刷物と画面上の両方の資料、およびビデオや拡張現実システムなどの他のメディアに適用されます。そのガイダンスの多くは、ハードウェアおよびソフトウェアを含むシステムに関するユーザー向けの情報に適用されます。
以前の標準では、情報開発プロセスの結果を 1 冊の書籍または複数巻のセット、つまり 1 回限りの成果物と見なす傾向がありました。情報取得者や供給者は、ユーザー向けのほとんどの情報が、新しいソフトウェアやシステムのバージョンに合わせて、以前に開発された情報 (単一ソースのドキュメント) の管理された再利用、またはさまざまな画面上や印刷媒体での表示によって作成されているということをますます認識しています。このドキュメントではコンテンツ管理システムのセットアップ方法については説明しませんが、単一ソースのドキュメントを実践している組織や、ワンタイム成果物の取得者やサプライヤーに適用できます。
ソフトウェアを含む製品を使用する人は誰でも、そのソフトウェアがユーザーのタスクの達成にどのように役立つかについての正確な情報を必要としています。ユーザーにとっての情報は、ユーザーが最初に目にする具体的なアイテムとなるため、製品に対するユーザーの第一印象に影響を与えます。情報が便利な形式で提供され、見つけやすく、理解しやすい場合、ユーザーは製品の使い方にすぐに習熟できます。したがって、ユーザー向けに適切に設計された情報は、ユーザーを支援し、トレーニングやサポートのコストを削減するだけでなく、製品、その製造者、およびサプライヤーの評判を高めることにもなります。
ソフトウェア開発者は、個別の情報がほとんど必要ないほど直観的に動作するユーザー インターフェイスを設計することを意図していますが、これが可能になることはほとんどありません。今日のソフトウェアは、アプリケーション内だけでなく、相互に情報をインテリジェントに交換するアプリケーション間でも、ますます堅牢な機能を提供します。さらに、ほとんどのソフトウェアには、ユーザーがソフトウェアを使用するときに得られる結果に影響を与える、基礎的なルールと計算、またはアルゴリズムが含まれています。これらの基礎となるプログラミングの仕組みはユーザーが識別できますが、それは骨の折れるテストによってのみ可能です。これらおよびその他の理由により、ユーザー向けの情報は、使用可能なソフトウェア製品およびシステムの不可欠な要素であり続けます。
ユーザーへの情報提供は、システム導入後に行われるものと考えられがちです。ただし、高品質の情報の場合、その開発はソフトウェアまたはシステムのライフサイクルの不可欠な部分と見なす必要があります。実際、ユーザー向けの質の高い情報や情報管理サービスは、特別な計画が必要なほど重要です。
ソフトウェア ユーザー向けの情報を取得および提供するための関連規格には、ISO/IEC 26514:200, システムおよびソフトウェア エンジニアリング - ユーザー ドキュメントの設計者および開発者の要件、および ISO/IEC/IEEE 26513, システムおよびソフトウェアエンジニアリング - ユーザー向け情報のテスターおよびレビュー担当者の要件。他の国際標準は、ユーザー向けの情報と、管理者およびアジャイル プロジェクトの観点からの情報管理プロセスに対処しています。
この文書は、契約プロセスを構成する取得および供給プロセスと情報管理プロセスの実装として ISO/IEC 12207 および ISO/IEC 15288:2015 と一致しています。
このドキュメントは、専門のドキュメント部門があるかどうかに関係なく、あらゆる種類の組織での使用を目的としています。地域の基準や手順の基礎として使用できます。読者は、製品およびサービスの取得および供給に関する一般契約プロセスの経験または知識があることを前提としています。
この文書の条項の順序は、取得アクティビティがこの順序で実行される必要があること、またはユーザー向けの情報がこの順序で開発されたり、この順序でユーザーに提示される必要があることを意味するものではありません。
各条項では、要件は可能な限りメディアに依存しません。
付録 A および B のチェックリストは、情報製品の取得者および供給者がこの文書の要件への適合性を追跡するために使用できます。
参考文献には、この文書の作成に使用されたソース資料への参照だけでなく、取得者やサプライヤーにとって役立つ可能性のある追加情報のソースも含まれています。
Introduction
This document was developed to assist users of ISO/IEC/IEEE 15288:2015 or ISO/IEC 12207 to acquire or supply systems and software information for users and information services as part of the life cycle processes. It defines the information development process from the acquirer’s standpoint and the supplier’s standpoint. This document addresses the identification, definition, and fulfillment of requirements for information for users as part of the acquisition and supply processes.
This document covers the requirements for information items used in the acquisition of information for users: the acquisition plan, document specification, statement of work, request for proposals, and the proposal. It also discusses the use of a Document Plan in the acquisition and supply processes.
This document is independent of the software tools that can be used to produce information for users, and applies to both printed and on-screen material, and to other media such as video or augmented reality systems. Much of its guidance is applicable to information for users for systems including hardware as well as software.
Earlier standards tended to view the results of the information development process as a single book or multivolume set: a one-time deliverable. Increasingly, information acquirers and suppliers recognize that most information for users is now produced from managed re-use of previously developed information (single-source documentation) adapted for new software or system versions, or presentation in various on-screen and printed media. While this document does not describe how to set up a content management system, it is applicable for organizations practicing single-source documentation, as well as for acquirers and suppliers of one-time deliverables.
Anyone who uses products that contain software needs accurate information about how the software will help the user accomplish a task. Information for users can be the first tangible item that the user sees, and so influences the user’s first impressions of the product. If the information is supplied in a convenient form and is easy to find and understand, the user can quickly become proficient at using the product. Therefore, well-designed information for users not only assists the user and helps to reduce the cost of training and support, but also enhances the reputation of the product, its producer, and its suppliers.
Although software developers intend to design user interfaces that behave so intuitively that very little separate information is needed, this is rarely possible. Today’s software offers increasingly robust functionality, not only within applications, but also across applications which intelligently exchange information with one another. Further, most software includes underlying rules and calculations, or algorithms that affect the results a user can obtain when using the software. These underlying programming mechanics are discernable by users, but only through laborious testing. For these and other reasons, information for users remains an essential component of usable software products and systems.
Information for users is often regarded as something done after the system has been implemented. However, for high-quality information, its development needs to be regarded as an integral part of the software or system life cycle. In fact, quality information for users or information management services are important enough to require specific planning.
Related standards for those acquiring and supplying information for software users include ISO/IEC 26514:2008 (IEEE Std 26514-2010), Systems and software engineering - Requirements for designers and developers of user documentation,and ISO/IEC/IEEE 26513, Systems and software engineering - Requirements for testers and reviewers of information for users.Other International Standards address the information for users and information management processes from the viewpoint of managers and agile projects.
This document is consistent with ISO/IEC 12207 and ISO/IEC 15288:2015 as an implementation of the Acquisition and Supply processes, which comprise the Agreement processes, and of the Information Management process.
This document is intended for use in all types of organizations, whether they have a dedicated documentation department or not. It can be used as a basis for local standards and procedures. Readers are assumed to have experience or knowledge of general agreement processes for acquisition and supply of products and services.
The order of clauses in this document does not imply that the acquisition activities need to be performed in this order, nor that information for users needs to be developed in this order or presented to the user in this order.
In each clause, the requirements are media-independent, as far as possible.
The checklists in Annexes A and B can be used to track conformance with the requirements of this document for acquirers and suppliers of information products.
The Bibliography contains references to source material used in the development of this document, as well as sources of additional information that might be useful to acquirers and suppliers.