|3.3 Service Complex: User Interface|
|SUI03 - Help Functions|
LNSS03 - Hilfefunktionen
|SUI03.F.1.1||Selection of help text||It is possible to request help text for the functions of the tool.|
|SUI03.F.1.2||Help about help||It is possible to request a help text about the call and use of the help function.|
|SUI03.F.1.3||Keyboard assignment||It is possible to display the current keyboard assignment. This includes the assignment of the function keys and of the key combinations (e. g. Control, Esc).|
The help function is context-sensitive.
The offered help text depends on the operation just processed and on the actual position held in the application.
It is possible to request further help for certain key words in a help text.
These key words are specially marked, e. g. they have a colored background.
|SUI03.F.1.6||Last error message||It is possible to request help for the last error message.|
|SUI03.F.1.7||Help via index||It is possible to request help via an alphabetically sorted list of key words.|
|SUI03.F.1.8||Degree of help||
It is possible to change the degree of help offered during a session.
It is possible, to choose between the degrees "short", "medium" and "long". A first-time user of the tool will select the "long" help text, an experienced user will probably select the "short" help text.
|SUI03.F.1.9||Individual help texts||
It is possible to integrate individually generated help texts into the tool.
This is helpful if self-generated functions can also be integrated into the tool.
|SUI03.F.2.1||Switch||It is possible to switch between help window and application.|
|SUI03.F.2.2||Simultaneous display||It is possible to display help windows and application simultaneously.|
|SUI03.F.2.3||Several help windows||It is possible to display several help windows simultaneously.|
|SUI03.F.3||Printing help text||It is possible to print out help text.|
|SUI03.F.4.1||Table of contents||The documentation includes a table of contents.|
|SUI03.F.4.2||Installation instructions||The documentation includes installation instructions.|
|SUI03.F.4.3||Introduction||The documentation includes an introduction for first-time users.|
The documentation includes a brief reference.
This reference gives an overview of the most important functions and the corresponding parameters. It must be easy to handle (e. g. as a folder) and to be placed next to the keyboard.
The documentation completely describes the functionality of the tool.
Detailed examples should be available for the individual functions.
The documentation includes a complete list of the messages, the corresponding causes of the errors, and the recommended correction measures.
This list should differentiate between different message types (alarms, errors, etc.) and, within these categories, this list should be in alphabetical order or sorted according to error keys.
The documentation contains a list of the special features dependent on the implementation.
This also includes the limitations dependent on the implementation (e. g. maximum number of lines in a file that can be processed with an editor).
|SUI03.F.4.8||Compatibility||The documentation comprises information about the upward and downward compatibility between tools releases.|
The documentation contains a global glossary.
In the case of a large documentation consisting of several volumes, the global glossary refers to the page in the corresponding volume. This simplifies direct access considerably.
|SUI03.F.4.11||Correct tool version||The documentation refers to the right version of the documented tool.|
|SUI03.O.1||Comprehensibility||Help texts are understandable and comprehensible.|
|SUI03.O.2||Language||It is possible to formulate the message texts in a way matching the corresponding linguistic environment.|
|SUI03.O.3||Examples||The help texts include examples.|
|GDPA Online Last Updated 01.Jan.2002 Updated by Webmaster Last Revised 01.Jan.2002 Revised by Webmaster|