Terminology and Wording

Terminology and Wording

Note: Consider consulting with a technical writer before you commit UI text. Tech writers can help with clarity and consistency of UI text.

Avoid Using "Please"

Using "please" is unnecessary, unless you are asking the user to do something that is inconvenient or a result of a system error.

Select custom application

Error encountered while executing the selected rules. Please contact system administrator for further assistance

Please Select a custom application

Error encountered while executing the selected rules. Contact system administrator for further assistance

Avoid Using Words Interchangeably

Some words can have multiple meanings, depending on the context. Often, these words are used interchangeably with another word. For clarity, select and consistently use the less ambiguous meaning for each word.

For example, because and since should not be used interchangeably. The word since can have two meanings. To avoid ambiguity, always use because to provide a reason, and use since when referring to a specific point in time.

Group approval for {0} was deleted because it no longer matches approval rule {1}

Group approval for {0} was deleted since it no longer matches approval rule {1}

As another example, once and aftershould not be used interchangeably. The word once has two meanings. Always use after when referring to events that occur later than or in succession to another event, and use once when referring to events that occur one time.

You cannot change the State after it is Closed or Canceled

You cannot change the State once it is Closed or Canceled

Spell Out Contractions

Contractions can be hard to translate. Avoid contractions if at all possible.

You do not have any archived tasks

You don't have any archived tasks

Use Present Tense

Present tense is easier to read and understand.

Avoid future tense and past tense if at all possible.

Problem is closed when the related change is marked Closed Complete

Problem will be closed when the related change is marked Closed Complete

Write Brief But Effective Text

In messages that tell users about an action that they can perform, use active voice by providing a direct command or addressing users directly with you.

Specify the start date

You can create bookmarks by dragging a link to the left edge

Start date must be specified

Bookmarks are created by dragging a link to the left edge

Only include enough detail to help users complete tasks.

Provide a brief explanation for rejecting this code

Edit the report settings, and then click Run Report

Enter your comments for rejecting this code. This comment will be useful for the developer who submitted this code change

You've chosen Edit mode, make adjustments above and press the button titled Run Report

Remove unnecessary words. Examples of words that you can usually remove without altering your meaning include: - Adverbs. For example, really, quickly, and easily. - Articles (for example, the, a, and an) in the beginning of sentences. - Forms of “to be” that are used with another verb.

Article was not found

Chart is loading

Unfortunately, the article cannot be found

The chart is being loaded