Skip to main content

Grammar and vocabulary

Grammar tenses

  • Use present simple tense to describe an action or instruction

  • Only use simple verb forms in the past or future when necessary

click, browse, upload
clicking, being clicked, was clicking
file loads, file loaded
file is going to be loaded, file has been loaded

Active voice

Configuration file opens.
The configuration file is opened.
Admin provides read-only access.
Read-only access is provided by Admin.
Measure performance.
Performance is measured.
Click submit.
Submit is clicked by user.
Calculate the data.
The data is calculated by application.

UI terminology

  • Mouse terminology: drag, hover, point, tap, click

  • Touchscreen gestures: tap, drag, flick, touch and hold, double-tap, swipe, pinch, spread

  • Basic terminology: checkbox, drop-down, field, icon, menu, link, radio button, window

click
press
hover
mouse over

Idioms and phrasal verbs

  • Avoid multi-word phrasal verbs when one word works

  • Avoid idiomatic expressions

  • Avoid cultural references

remove
get rid of
calculate
add up
continue
carry on
mobile device
Apple, Android, iOS, smartphone

Jargon, buzz words and terms

  • Use simple vocabulary

  • Do not avoid technical terms but consider if you need to explain them

  • Define new or unfamiliar terms and use existing explanations (do not reinvent the wheel)

Abbreviations and acronyms

  • Avoid abbreviations (info, incl, excl) and acronyms (SIOS for Siemens Industry Online Support)

  • Explain acronyms initially and in full unless well known: Asset Performance Suite (APS)

  • Capitalization only for acronyms that are proper nouns

  • No periods in abbreviations or acronyms

  • Never make up your own acronyms: https://www.acronymfinder.com/

light emitting diodes (LEDs)
Light Emitting Diodes (LEDS)
APS
A.P.S.
EU
E.U.
I/O component, I/O list, I/O module
IO component, i/o list, I-O module

Time based vocabulary: Last, latest and recent

  • Last implies nothing else will follow. It's the last, and after this it is finished. No more are coming.

  • Latest implies that it is the last to date, which means there could be more to follow. Most recent. Newest.

  • Recent is more time focused and is similar to latest. It means that it happened a short time ago.

Latest update
Last update
Latest summary
Last summary
Recent events
Last events