Skip to content
Indiana University Logo
Rivet Design System
  • Components Add-ons Content guide
  • What is Rivet? Blog Roadmap Changelog
  1. February 25, 2021

    Rivet 1.8.0 release

    Rivet 1.8.0 is now available. This release adds border removal utility classes and fixes bugs related to the button, dropdown, and collapsible components.

  2. February 15, 2021

    Rivet announcements: Beta timeline, GitHub Discussions, and 1.8.0 release

    Updates about Rivet's development in the spring and beyond.

  3. January 20, 2021

    Rivet featured on Accessible Code Libraries and Design Patterns list

    Rivet was highlighted alongside the U.S. government, GOV.UK, and Salesforce design systems.

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
Version 1.8.0
  • 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

Content guide

Learn how to write content that works for your users.

Our approach

Start with user needs

  • Write in a way that suits the situation. Ask yourself: Who is going to read this? What do they need to know? How might they be feeling?
  • Help people find the information they need quickly and easily. Guide them through the process.

Do the hard work to make it simple

  • Use plain language and simple sentences.
  • Choose clarity over cleverness.
  • Be concise.

Write for everyone

  • Respect the complexity of our users’ experiences.
  • Be willing to be surprised about who’s reading your work.

Build trust

  • Talk like a person.
  • Tell the truth.
  • Use positive language and concrete examples.

Start small and iterate

  • Make sure your content works for users. Don’t be afraid to scrap what’s there and start over.
  • Write a draft, test it out, gather feedback, and keep refining.

We drew heavily from 18F’s content guide to create this microcopy guide. Many thanks to 18F for keeping their work in the public domain!

Have a question about Rivet?

We're happy to help! If you've found a bug, typo, or have a request, the best way to get in touch is to create an issue on Github.

For all other questions please feel free to email us at rivet@iu.edu

  • Accessibility
  • Privacy Notice
  • Copyright © The Trustees of Indiana University