Skip to content
Indiana University Logo
Rivet Design System
  • Components Add-ons Content guide Migration guide
  • What is Rivet? Blog Changelog
  1. May 4, 2022

    Rivet 2.0.0-beta.4 release

    The fourth Rivet 2 beta release introduces design updates to several components and a new responsive table wrapper element.

  2. March 30, 2022

    Rivet 2.0.0-beta.3 release

    The third Rivet 2 beta release updates accordion, badge, and button styles.

  3. February 9, 2022

    Rivet 2.0.0-beta.2 release

    The latest Rivet 2 beta release introduces the link hub component, adds new utility classes, and refactors component JavaScript.

More posts Get updates in your inbox
Install via NPM Download CSS & JS Hosted assets
Navigation
    • Components
    • Add-ons
    • Content guide
    • What is Rivet?
    • Blog
    • Roadmap
    • Changelog
  • Use Rivet
Resources
  • User Experience Office
  • Accessibility Evaluations
  • Rivet Software Design System
  • IU Framework for WCMS
Rivet 1 has been retired and will no longer receive updates. The v1 source code has been archived here. Please migrate to Rivet 2 as soon as possible.
Version 1.8.3
  • Microcopy
    • What is microcopy?
    • Address the user
    • Active voice
    • Plain language and structure
  • Style basics
    • Capitalization
    • Naming conventions
    • Numbers and dates
    • Punctuation
    • Technical terms and acronyms

Plain language and structure

One of the best ways to make content clear and usable is to use plain language. When we use words people understand, our content is more findable, accessible, and inclusive.

To use plain language, you should:

  • Use easy or short words instead of formal or long ones

    Buy instead of purchase, help instead of assist, about instead of approximately, etc.

  • Avoid using technical jargon

    Jargon can be vague or unfamiliar and lead to misinformation–which could affect users’ trust.

  • Be open and specific

    Figurative language (go forward, one-stop shop, drive out, etc.) often doesn’t say what you actually mean. Simply describe what the user should do.

If you’re struggling to use plain language, try writing conversationally. Picture your audience and write as if you were talking to them one-on-one, with the authority of someone who can actively help.

Structure your text

Online, users tend to scan text until they find the information they need. Large chunks of text can overwhelm readers, so break up your text.

  1. Use subheads and bullet points—they provide clear narrative structure for readers in a hurry.

  2. Don’t be afraid to use bold or italics to grab attention. If you want to include an inline tip or highlight a note, words in bold stand out from the rest of the content.

  3. Put information-carrying words at the beginning of the phrase. You should also use the active voice.

Instead of:

Information and policies regarding the usage of IU branding assets

Use:

IU branding asset information and policies

On this page

  • Structure your text
  • Accessibility
  • Privacy Notice
  • Copyright © The Trustees of Indiana University