Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Directional Language

      +

      Do not use directional language to describe where UI elements are located to the user. Directional language includes words like:

      • up

      • down

      • left

      • right

      • above

      • below

      To avoid directional language, do not describe the UI visually, or in relation to other UI elements, where possible. Stick to button names or icons as much as possible.

      If the automatic Vale rule flags a use of directional language:

      • If the usage is describing values, such as a value above 10 or a value below 20, rewrite the sentence to use a value greater than 10 or a value less than 20, respectively.

      • If the usage is in a valid phrase, such as back up, let the tooling team know so that an exception can be added to the rule.