A.1 Introduction

A.1.1.3.1 Standard identification

Standard identification shall be in the natural language of the documentation.

Standard identification text shall be displayed prominently:

1. in a prominent location in the front matter of all publications (normally the title page and cover page);

2. on all identifying display screens of Extended Facilities programs; and

3. in all promotional and training material.

For applications, the identification text is:

An SGML Extended Facilities application conforming to
Annex A of International Standard ISO/IEC 10744 --
Hypermedia/Time-based Structuring Language

For systems, the identification text is:

An SGML Extended Facilities system conforming to
Annex A of International Standard ISO/IEC 10744 --
Hypermedia/Time-based Structuring Language

The documentation for a conforming SGML Extended Facilities system shall include the relevant system declarations or definition documents.

NOTE 379 For example, a storage manager definition document for Formal System Identifiers.

A.1.1.3.2 Identification of Extended Facilities constructs

The documentation shall distinguish Extended Facilities constructs from application conventions and system functions, and shall identify the Extended Facilities constructs as being part of the facility used.

NOTE 380 The objective of this requirement is for the user to be aware of which constructs are common to all Extended Facilities systems, and which are unique to this one. This will reduce the experienced user's learning time for a new system or application.

This International Standard and annex shall be cited as a reference for supported Extended Facilities constructs that are not specifically documented for the system or application. For example, if, for simplicity's sake, only a subset of some function is presented, it shall be stated clearly that other options exist and can be found in this International Standard.

A.1.1.3.3 Terminology

All Extended Facilities constructs shall be introduced using the terminology of this International Standard, translated to the national language used by the publication or program.

Such standard terminology should be used throughout the documentation. If, notwithstanding, a non-standard equivalent is used for a standard term, it must be introduced in context and it shall not conflict with any standard Extended Facilities terms, including terms for unsupported or undocumented constructs.

A.1.1.3.4 Application conventions

A conforming SGML Extended Facilities system shall not enforce application conventions as though they were requirements of this annex.

NOTE 381 Warnings of the violation of application conventions can be given, but they must be distinguished from reports of facility errors.