Writing for the Web: a 30 minute overview

I created a video presentation for this semester’s UX4Justice class, so I’m sharing it here along with an overview of the content:

Why it matters

The #1 reason people visit websites is for the content. They want their questions answered.

How people tend to read on the web

  • Skim: They skim for headings and keywords, often in an F-shaped pattern.
  • Hunt: They hunt for links and buttons that will take them to the right place.
  • Muddle through: They try different things and often don’t take the path you’d expect.

How people might feel on the web

  • Impatient: The first 10 seconds is critical.
  • Distracted: They’ll often be doing multiple things at once.
  • Frustrated: Bad writing can quickly cause people to leave.

Tip #1: Conversational. Speak directly to website visitors.

  • Write like you talk.
  • Use active voice.
  • Use fragments.

Tip #2: Relevant. Speak directly to users’ questions.

  • Define your audience for your website.
  • Define your audience, page by page.

Tip #3: Focused. Prioritize and simplify your messages.

  • Prioritize top tasks.
  • Use the inverted pyramid.
  • Keep things short.
  • Simplify phrases.
  • Remove the unnecessary.

Tip #4: Clear. Make your content accessible to as many people as possible.

  • Avoid ambiguity.
  • Provide help at the point of need.
  • Avoid long noun phrases.
  • Make links clearly links.
  • Format nicely.

Tip #5: Organized. Use structure to facilitate navigation.

  • Use parallelism.
  • Use meaningful headings.
  • Use meaningful link labels.
  • Make clear calls to action.

See the full slide deck.

Writing Accessible Web Content

I’ve written and taught on the topic of web content for a number of years. And this past year, I’ve been thinking a lot about how our content decisions impact the accessibility and inclusivity of our websites.

Last month, I presented the keynote at a Ferris State University’s symposium, Web Content for Everyone: Usability, Accessibility, and Content Creation. The audience included web developers, marketers, instructors, writers, and other staff from across campus.

The goal of this presentation was to cover the key principles to creating content that is useful, usable, and accessible to all. I discuss techniques including plain language, heading structure, content prioritization, meaningful links, alternative text, and more. My 5 tips for better, more inclusive web content are:

  1. Know your audience. Create content with your readers in mind.
  2. Keep it focused and simple. Reduce cognitive load with straightforward and succinct content.
  3. Focus on clarity. Strive for immediate comprehension.
  4. Organize and structure. Your content flow should be intentional, point-of-need, and easy to skim.
  5. Make it readable. Be intentional with font choice, white space, and formatting.

Big thanks to Ferris State for inviting me, and for recording and captioning the presentation!


Tips for Making Better Forms

icon of a form

Forms are prevalent across the web, yet so many are poorly designed. They can quickly become a source of frustration.

Last year, Ann Shivers-McNair and I bonded over our passion for form content and design. So we developed a presentation on making better forms for people, presented at edUi last October.

Forms have been on my mind a lot recently, and I thought it would be useful to unpack the presentation into some of the key principles and considerations for easy reference. And I’ve added and slightly revised a couple based on other things I’m learning. So here goes.

3 key principles

Simplicity. Avoid the complicated and unnecessary.

  • Avoid instructions on how to fill out the form
  • Make sure every field serves a purpose
  • Get rid of any unnecessary fields (e.g. phone number, fax number, birthdate)
  • Never require a field if you don’t really need it

Inclusivity. Create forms for everyone.

  • Avoid jargon
  • Avoid legalese
  • Write like you talk
  • Be inclusive in your options

Readability. Use logical sequencing and follow conventions.

  • Be succinct
  • Place field labels above the field
  • Left justify, rag right
  • Allow for lots of white space
  • Use sentence case

Small but mighty considerations

Form names. Make it clear what you’re doing.

  • Start with a precise action verb (e.g. “Apply,” “Request”)
  • Use an action verb in the link to the form, too (e.g. “RSVP for event”)
  • Avoid too many nouns in a row

Optional vs. required fields. Make them intuitive to recognize. (Be aware these conventions are a moving target and may depend upon audience).

  • Most fields should be required
  • Indicate which fields are optional by saying optional
  • Be consistent in how you indicate required vs. optional fields
  • Asterisks are a common convention to mean “required”

Name fields. Make them inclusive.

  • Don’t limit character length (or if you must limit, make that limit 70 characters for full name or 50 characters for first name or last name)
  • Don’t force first-letter capitalization (e.g. charley)
  • Don’t prevent capitalization of a second name or within a name (e.g. Bonnie Jean; McClelland)
  • Allow hyphens in names (e.g. Sykes-Casavant)
  • Use one “Full name” field over separate “First name” and “Last name” field, unless it’s really necessary

Gender fields. Make them inclusive.

  • Avoid binary gender selectors
  • Allow write-in responses
  • Make it optional (when possible)

Selectors. Give clear options.

  • Pick a thoughtful default that’s either the most common answer or the first in a logical sequence
  • Put the most common options at the top, and for longer lists, use alphabetical sequencing
  • Use the right selector for the information you are soliciting (e.g. dropdowns, radio buttons, check boxes)

Question scope. Ask one question at a time.

  • Don’t combine multiple questions into one
  • Isolate the pieces of information you are asking for
  • Use logic to order questions that follow from previous information

Contextual help. Provide helpful hints at the appropriate time. (Be aware these conventions are a moving target and may depend on audience).

  • Use field labels to describe the field, and place them above the field
  • Use help text to provide an explanation or further information
  • Maybe use placeholder text to suggest the type of content you expect
  • Be cautious with placeholder text, and don’t use it as a substitute for field labels or help text

Feedback messages. Provide informative messages at the right time.

  • Make it clear when there are errors
  • Make it clear what any errors are
  • Don’t stress users out with error messages before it’s necessary
  • In confirmation messages, make it clear what the user just did and what to expect next

The slidedeck

Here’s the slidedeck that these tips were based on. It includes a few more details and a whole bunch of examples.

Hope you find this helpful! Please share comments on other things I should add.

Writing for the Web at Internet Librarian

Writing for the web has long been a passion of mine. I presented on it back at edUi in 2013, Nicole Capdarest-Arest and I created the course for Library Juice Academy and I’m currently writing a book related to the topic.

At Internet Librarian this week, I was thrilled to present on it alongside David Lee King. It was a lot of fun – we talked about why web writing matters, why we’re not so good at it, and how we can do it a bit better. Sadly our third panelist, Elaine Meyer, wasn’t able to attend at the last minute, but I think David did her justice in presenting her content.

Thanks for everyone who came out and participated. It’s cool to see so many people interested in creating better experiences through better content. I had a blast. Here’s my slide deck:


Presentations at edUi 2013

I was fortunate to attend edUi for the second time this year. Excellent conference that brings together leaders in user experience from the higher ed community. I presented twice – first with colleague from UNC Chapel Hill, Kim Vassiliaddis on bringing together stakeholders and leading staff during times of big changes:


I then presented with former colleague, Samantha Barry, on techniques for effective web writing: