Revel
GitHub
GitHub
  • Overview

    • Getting started
    • FAQ
    • Release notes
  • Foundations

    • Meet the standard
    • Accessibility
    • Internationalization
    • Information hierarchy
    • Speed
  • Design

    • Visual principles
    • Colors
    • Space
    • Icons
    • Typography
  • Design tokens
  • Style helpers
  • Content

    • Express your ideas
    • Actionable language
    • Inclusive and accessible language
    • Alternative text
    • Grammar and mechanics
      • Basics
      • Capitalization
      • Dates and units of measurement
      • Punctuation
  • Components

    • Alert
    • Avatar
    • Badge
    • Button
    • Button group
    • Checkbox
    • Date Input
      • dates
      • datetimes
      • ranges
    • Field group
    • File upload
    • Flex
    • Grid
    • Icon
    • Image
    • Input
    • Loader
    • Modal
    • Month picker
    • Pagination
    • Popper
    • Radio
    • Repeater
    • Select
    • Tabs
    • Tile
    • Toast
    • Toggle
  • Directives

    • Click outside
    • Tooltip

Express your ideas

Use a conversational tone and voice when writing content for Graphical User Interfaces (GUIs). You're communicating with a person, the language you use has an enormous impact on that persons experience. Write as though you're speaking with someone in a business context. Be upfront, honest, and use empathy. Be direct, but not insensitive.

Research shows that people follow social norms when communicating with GUIs. If the interface breaks these rules, people become frustrated, and even angry. Similarly, if the GUI uses inconsistent content, people find it difficult to trust the product.

Create a positive experience and engage the user by using the guidelines described in this section.

Actionable language

Write and structure your content in a way that helps the user to understand and get things done.

Inclusive and accessible language

The words that you choose to use in your content have power. Use that power well.

Alternative text

Provide an inclusive and accessible experience to all your users.

Grammar and mechanics

Write concisely and consistently.

Edit this page
Last Updated: 7/23/25, 9:31 AM
Contributors: noon-dawg, Cesar Level, John Hannagan, Weetbix, Giorgi Kakhoshvili
Next
Actionable language