Smashing Magazine - #418: UX Writing and Microcopy

On UX writing, bias-free language, and guidelines around readability and plain language for more inclusive writing. Issue #418 August 15, 2023 View in the browser

Smashing Newsletter

Hello Smashing Friends,

Words matter. Sometimes we rely on labels and calls to action that appear to be obvious and self-explanatory. Yet too often, they come from assumptions that clash against reality and sometimes come across at best as inconsistent and at worst as confusing, disrespectful, and inconsiderate.

In this newsletter, we’d like to shed some light on wonderful resources on UX writing — resources that can help us write better copy, avoid confusion, and maximize clarity.

Meets Magical UX
Join us online for our free Magical UX community event on Sep 14.

We’ll be exploring UX writing and UX in general in a few of our upcoming events as well:

In the meantime, thank you so much for reading — and let’s explore a few useful bits around UX writing!

Vitaly


1. The Micropedia Against Micro-Aggressions

Words are everything on the web. Yet when we choose words poorly, when the words come from implicit bias or stereotypes, it can come across as insulting and disrespectful, although you might not mean it this way at all. How can we prevent these things from happening?

The Micropedia

The Micropedia highlights comments and actions that are based on stereotypes, assumptions, and lack of empathy across age, disabilities, class, ethnicity, gender, indigenous people, race, religion, and 2SLGBTQ+. With plenty of examples to keep in mind. A huge thank-you to the team behind the project working on it! (vf)


2. Plain Language Guidelines

Plain language makes it easier for your audience to read and understand your content. But how to achieve that? How to write clearly? That’s exactly what the Plain Language Guidelines attempt to answer. An initiative by the US government, Plain Language features practical tips to take your writing to the next level, covering everything from researching your audience to testing assumptions.

Plain Language

In the first step, you’ll learn to better understand who you are writing for. You’ll then move on to organizing information and making it easy to follow. The actual writing principles make for the most extensive section, starting at the word level and moving up through paragraphs and sections. A comprehensive overview with lots of examples that illustrate how small tweaks make a huge difference for your readers. (cm)


3. Bias-Free Language

We have learned to check our writing for spelling, grammar, and wordiness, but what about bias? The American Psychological Association published a guide to bias-free language that helps you identify bias and write about people without creating it.

Bias-Free Language

The guide dives deep into addressing the individual characteristics of age, disability, gender, participation in research, racial and ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Practical writing examples of problematic and preferred wording help you make bias-free language a natural part of your writing routine. (cm)


4. Good Microcopy

No interface without microcopy. Whether on buttons, in error messages, or form fields, microcopy is everywhere, providing context and helping users reach their goals. If you’re looking for examples of how to master the craft of providing real value in just a few words, the site Good Microcopy has got you covered.

Good Microcopy

Curated by Richard Sison, Good Microcopy showcases examples of, well, great microcopy. And not only that, Richard also explains what makes each of the examples stand out. It might be an “I’ll do this later” button that reduces friction when a user is eager to quickly try out a service they have signed up for or a newsletter signup that reduces anxiety when handing over an email address by including a friendly “Once or twice a month. 100% goodness. 0% spam” underneath the signup button. A treasure chest of microcopy gems. (cm)


From our sponsor

Stripe, OpenAI, Amazon, and thousands of companies build apps faster with Retool

Retool: Build any business software, remarkably fast.
Build any business software, remarkably fast. Stop wrestling with UI libraries, hacking together data sources, and figuring out access controls. Start shipping apps that move your business forward. Learn more →


5. Cohesion In UX Writing

Driving cohesive narratives across all touchpoints within a product is a skill that is often required in UX writing job posts. But what does cohesion mean? And how to achieve it? Marina Nevolina takes a closer look.

Cohesion in UX Writing

In her post “Cohesion in UX Writing,” Marina explains the term cohesion and the four key aspects you need to keep in mind when thinking of it: consistency, voice, flow, and predictability. To put it all into practice, Marina shows how she enhanced cohesion and fixed inconsistencies in a real-world project she worked on. Practical tips for UX writers and everyone who delivers content for a project. (cm)


6. Upcoming Workshops and Conferences

That’s right! We run online workshops on frontend and design, be it accessibility, performance, or design patterns. In fact, we have a couple of workshops coming up soon, and we thought that, you know, you might want to join in as well.

Smashing Online Events
With online workshops, we aim to give you the same experience and access to experts as in an in-person workshop from wherever you are.

As always, here’s a quick overview:


7. Readability Guidelines

What if there was a central place where the community shared knowledge and created a universal content style guide that was accessible, usable, and evidenced? That was the idea Sarah Winters of Content Design London had back in 2018. The result is the Readability Guidelines wiki.

Readability Guidelines

For the Readability Guidelines, content collaborators from multiple sectors worked together to answer readability questions and develop a set of consistent guidelines to improve readability and usability. The topics covered range from clear language and grammar points to content design and images. You can explore the wiki’s more than 100 guidelines or get involved in the project to help it evolve. (cm)


8. UX Writing Resources

Do you want to dive deeper into UX writing? Then Content Designer Resources is for you. Created by the UX Content Collective, the collection features UX writing tools, free webinars, articles, podcasts, and resource libraries to help you improve communication with your users.

Content Designer Resources

Another handy resource is the UX Writing Library, a collection of books, blogs, communities, online courses, events, podcasts, newsletters, and more to give you a current and focused overview of UX writing. Whether you’re about to take your first step into UX writing or are looking to stay on top of what’s happening in the field, these two resources certainly won’t let you down. (cm)


9. Smashing Books (Print + eBooks) 📚

Promoting best practices and providing you with practical tips to master your daily coding and design challenges has always been at the core of everything we do at Smashing.

In the past few years, we were very lucky to have worked together with some talented, caring people from the web community to publish their wealth of experience as printed books. Have you checked them out already?

Success At Scale
… and we’re currently working on a new book: Success At Scale, shipping in fall. Pre-order your copy or browse the complete library.


10. Recent Smashing Articles


That’s All, Folks!

Thank you so much for reading and for your support in helping us keep the web dev and design community strong with our newsletter. See you next time!


This newsletter issue was written and edited by Cosima Mielke (cm), Vitaly Friedman (vf) and Iris Lješnjanin (il).


Sent to truly smashing readers via Mailchimp.
We sincerely appreciate your kind support. You
rock.

Follow us on Twitter Join us on Facebook

unsubscribe update preferences view in your browser

Older messages

#417: Inclusive Design

Tuesday, August 8, 2023

With gender-inclusive writing, inclusive design principles, inclusive mindset workbook and empathy prompts. Issue #417 • August 8, 2023 • View in the browser Smashing Newsletter Kalimera Smashing

#416: Figma Tools and Workflow

Tuesday, August 1, 2023

Figma workflow, variables, design system structure, design specs, file management UI library and a user journey map template. Issue #416 • August 1, 2023 • View in the browser Smashing Newsletter

#415: UX Workflow

Tuesday, July 25, 2023

Designing better meetings, folder structure, design critiques, UX design self-evaluation matrix and structuring files in Figma. Issue #415 • July 25, 2023 • View in the browser Smashing Newsletter Buen

#414: CSS

Tuesday, July 18, 2023

Modern CSS, proportional UI components, stacking elements, text reveal, sticky content and the ABCs of CSS. Issue #413 • July 18, 2023 • View in the browser Smashing Newsletter God eftermiddag Smashing

#413: UX Motion and Animation

Tuesday, July 11, 2023

How to document UX motion, animation, transitions — with useful animation tooling and motion-focused examples from design systems. Issue #413 • July 11, 2023 • View in the browser Smashing Newsletter

You Might Also Like

Celeb Homes at the Holidays—and a Few More Things to Make You Merry

Tuesday, December 24, 2024

View in your browser | Update your preferences ADPro Holiday Cheer Whether your taste leans traditional, modern, or all-out extravagant, AD is rife with inspiration for your holiday. In the spirit of

#488: Fun And Useful Gems

Tuesday, December 24, 2024

Radio garden, Zoom backgrounds, visual history of the alphabet and fun interactive experiences. Issue #488 • Dec 24, 2024 • View in the browser Smashing Newsletter Hello Smashing Friends, As we are

Accessibility Weekly #428: Putting AI to the (Accessibility) Test

Monday, December 23, 2024

December 23, 2024 • Issue #428 View this issue online or browse the full issue archive. Hey accessibility friends! It's the time of year where news and information slows down as many people take

2024 magic moments

Sunday, December 22, 2024

Issue 225: The year from my personal lens ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏

Planning mode

Friday, December 20, 2024

Lessons from our first-ever annual planning sprint ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏

We Co-Sign This AD100-Approved Trend

Thursday, December 19, 2024

View in your browser | Update your preferences ADPro Emboldening the Bath Marble, marble, everywhere, and every drop is chic. According to AD100 designer Jake Arnold, “material drenching”—that is,

177 / Keep calm by listening to these ambient sounds

Thursday, December 19, 2024

Product Disrupt Logo Product Disrupt Half-Monthly Dec 2024 • Part 1 View in browser Welcome to Issue 177 Lately, I've been driving a lot of inspiration from the things I see in real life. The range

The Year in Color: Hella Jongerius, Mocha Mousse, and More

Thursday, December 19, 2024

View in your browser | Update your preferences ADPro Color Our World Since the summer, AD PRO has kept its finger on the pulse of color predictions. Overall, the vibe right now is down to earth,

🐺Get Media Features in 2025

Thursday, December 19, 2024

A BIG Wolf Craft announcement!! ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏

Small teams

Thursday, December 19, 2024

Issue 224: Why the mentality of lean and small always wins ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏ ͏