TextConventions

Text conventions

Within the GUI, the user needs to be informed and requested to interact. Thus, a collection of text snippet types needs to be defined.

(This list needs to be filled and updated from time to time!)

Following snippets should be distinguished:

• Workflow Task: TODO
• Name of a tool (i.e. a button/ widget windows):

engl: Imperative (+ subject); all capital letters, no full stop! e.g. "Edit Roughness Zones", "Zoom In", "Measure Distances"

germ: Infinitive, e.g. "Fließwiderstandszonen bearbeiten"

• sectionwise headers wihtin tools representation (widgets): TODO

• Tool Tip to describe functionality of a tool and further some consequence information

engl: Repeat Tool Name in that convention; next line; Describe tool functionality in same manner as name with extended subject in first place; Add additional information in full sentences; use complete punctuation; not all capitals, e.g.

"Measure geometries of features in map panel.

Line length, polyline length and areas can be examined. Take care of hints in map tool disrcription."

germ: Repeat Tool Name; Infinitive, e.g. "Fließwiderstandszonen bearbeiten"

• Requests to interact, e.g. specification of a file from the file system

• Wizard window title and sub-title: TODO

• Wizard information due to the current Wizard data content: TODO