Overview

What makes products desirable is their simplicity and the ability to add value. Consistent use of understandable language lifts products to an even higher level. Writing good UI texts involves more than just linguistic correctness. You need to take into account also the consistency of the terminology used, comprehensibility, and tone of voice.

This guideline details the specifics of writing influential UI texts for technology products. Generally, always consider sending your UI texts for review to the UA Developer responsible for your product.

See also:

Fiori Design Guideline - UI Text Guidelines for SAP Fiori Apps

UA Documentation - About the SAP Style Guide for Technical Communication

General Recommendations

1
do
false

Recommended

  • Use correct spelling, grammar, and punctuation. Consider using a spell checker.
  • Use consistent, relevant, and easy-to-understand language.
  • Use a friendly tone of voice. Use people-centric language: clear, approachable, insightful, optimistic.
  • Use consistent capitalization.
  • Use active formulation and use "you" to address users.
1
dont
false

Not Recommended

  • Avoid using on-the-fly abbreviations or truncated text. Consult with SAP Term instead.
  • Avoid using passive form.

Resources

Fiori Design Guideline - UI Text Space Calculator

Fiori Design Guideline - UI Text Checklist

UA Documentation - SAP Term

UA Documentation. UA meets UX