UX Writing

The following standards aim to create a consistent voice and tone across all user interfaces. Just as visual elements like color and typography must be consistent, so should the language we use in Bauhaus Design System.

Principles

Clarity Use simple words and short sentences. Prioritize information; most critical information comes first.

Consistency Use the same term for the same action or feature across all platforms. Refer to UI elements exactly as they appear in the UI.

Empathy Write in the second person ("you") to speak directly to the user. Avoid jargon that the user might not understand.

Components

Buttons Use action verbs like "Save," "Submit," or "Download." Keep text short: 1-3 words.

Error Messages Clearly state the problem and a way to resolve it. Avoid blaming the user.

Form Fields Use sentence case for labels. Include helper text for clarification if necessary.

Tooltips Keep them short and concise. Use for supplemental information, not for essential instructions. For Ambiguous Terminology: If a term or label could be confusing or unclear, add a tooltip to clarify its meaning.

Tone and Voice

Voice: Friendly, professional

Tone: Varies based on context; however, generally neutral

Tense: Present tense whenever possible

Examples

Good "Find your files quickly."

Bad "Utilize the file search functionality for expedited file retrieval." For any questions or further guidance, please consult the Marketing department shall be consulted.