Smashing Magazine - #377: UX Writing

With UX writing guidelines, tools, library, inspiration and better error messages. Issue #377 November 1, 2022 View in the browser 💨

Smashing Newsletter

Howdy Smashing Friends,

Words matter. They matter when we speak them loudly, and they matter when remain silent. They matter when they are on labels and on buttons, but also when they occasionally appear in error messages and notifications. And the way we use them in tandem with voice and tone defines the perception our products have and the emotional connections they establish.

Copywriting isn’t UX writing. While the former explains the product in articles and marketing newsletters, the latter lives within the product in words we carefully place on each page.

But how exactly would you integrate UX writing into the design process? And what are some of the useful guidelines and best practices to keep in mind when working on UX writing? This is exactly what this newsletter is about — with plenty of tools and resources to get you started.

Smashing Meets Design Systems
Meet Smashing Meets: Design Systems (Tue, Nov 15), our regular online gathering — this time all around design systems.

That’s also what we will be exploring (at least partly) at our upcoming Design Systems Meets (Tue, Nov 15), a free community event that we organize for wonderful people just like yourself. Of course, we also have some friendly online workshops all around front-end & UX.

In the meantime though, off we go into the world of UX writing — happy explorations, everyone!

Vitaly (@vitalyf)


1. Readability Guidelines

What if there was one 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. You can explore the wiki’s more than 100 guidelines or get involved in the project to help it evolve. The topics covered range from clear language and grammar points to content design and images. (cm)


2. Better Error Messages

“Something went wrong.” There’s hardly anything worse than telling a user their input is invalid without giving them hints as to why that is or how they can fix it. But how can we do better? What can we do to improve our error messages to make it easy for the user to recover from form errors?

Error messages

In his post on the Baymard blog, Jamie Holst explores how the wording of validation error messages determines the user’s error recovery experience and how “Adaptive Error Messages” can significantly reduce the time a user needs to fix an error.

In her blog post “When life gives you lemons, write better error messages,” Jenni Nadler shares valuable insights into how her team at Wix changed thousands of error messages across the platform in just a month. She shares how they defined what counted as a bad error message and what counted as a good error message. Valuable tips that you can incorporate into your work right away.

Vitaly Friedman dives deep into the UX of error messages. In his article “Designing Better Error Messages UX,” he explores when error messages should live above input fields and why toast error messages are usually not a good idea. (cm)


3. Manage Your Copy

In many teams, copy is something you paste from an email or a Slack chat. There’s no single place to iterate on it or to get feedback, the way there is for design. Andrea Drugay shares a simple yet effective way to improve the way you deal with copy: copy docs.

Improve Your Design Process With Copy Docs

A copy doc is the one stop for everything copy-related in a project, one document that holds all your copy — from the landing page to onboarding emails. Your copy doc can be a simple Word document, Dropbox Paper, Google Doc, or whatever else you might prefer. If you want to give it a try, Andrea shares some valuable tips on setting up a copy doc.

Are you looking for a more advanced solution? Ditto is a lovely tool that acts as a single place to manage the copy in all of its stages. It allows you to build a text component library, track all copy changes, and review and discuss edits, too. (cm)


From our sponsor

Introducing iA Presenter

Introducing iA Presenter
“Incredible innovation around presentation software. iA Presenter has responsive layouts, typographic themes, and great UX, all created within a text editor. Beautiful work, iA!” — Vitaly Friedman


4. Better UI Copy

Helping you with copy that converts, and perhaps even make you smile. That’s the mission of UI Copy. The plugin for Figma and Adobe XD contains pre-built templates for your UI. It’s not generated randomly or with the help of AI but is curated by real humans to give it a personal touch.

UI Copy

To build the repository of words and phrases, the team behind UI Copy analyzed thousands of conversion-oriented websites and used years of experience to think up words and phrases that are engaging to read. Whether your brand’s voice is formal or informal, UI Copy delivers copywriting ideas bound to remove your writer’s block. Available only with a subscription. (cm)


5. The UX Writing Library

Whether you want to stay on top of the game or are taking your first steps into the world of UX writing and content design, the UX Writing Library gathers plenty of useful resources in the field.

The UX Writing Library

Curated by UX writer and microcopy expert Kinneret Yifrah, the library organizes books, blogs, communities, online courses, events, podcasts, newsletters, and everything in between in a way that is easy to navigate and use. If you know of a resource that isn’t featured yet, you are welcome to submit it. A great hub to get a current and focused overview of the field. (cm)


6. Upcoming Design & UX Workshops

That’s right! We run hands-on online workshops, be it accessibility, navigation, 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 an overview of our upcoming workshops:


7. When Words And Tech Meet

#writingTech is the place where words and technology meet. The site provides you with information, tools, and resources to leverage the newest tech to take your content and localization workflows to the next level. A special focus lies on AI.

When Words And Tech Meet

In the reading zone, you’ll explore design, branding, AI copywriting, UX writing, and localization. The section on tools gives you an overview of tools that generate AI copy and help with content management, as well as tools for localization and translation management. (cm)


8. Copywriting Inspiration

Do you need some copywriting inspiration? Copywriting Examples collects copy examples — from vintage ads to marketing copy from modern startups and global tech players — and breaks down why the copy works. You can filter out the examples by type, style, and audience. Interesting insights into how little details shape a message.

Copywriting Examples

Whenever you need copy for a design or if you get stuck in the middle of development, Copy Book has got your back. The site features commonly used texts for anything from features and accounts to upsell and authentication. You can browse the collection by tag, category, and even mood.

Speak Human is also a great little gem. It generates human-centric microcopy for various purposes, from errors to confirmation messages. Not ideal for copy-pasting, of course, but useful to inspire us all to write better copy.

If you need a helping hand with emails, Good Email Copy highlights examples of email copywriting, tagged and grouped, with search. There aren’t that many examples for each topic, but it might be just enough to help out when help is needed. (cm)


From our sponsor

Northwestern’s Online MS in Information Design and Strategy

Northwestern’s Online MS in Information Design and Strategy
Prepare for a range of dynamic communication roles and build the skills needed to lead communication strategy, translate complex data, and drive user interactions. Choose from specializations in content strategy, UX/UI, communication with data, and learning design. Learn more.


9. New On Smashing Job Board


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.

unsubscribe update preferences view in your browser

Key phrases

Older messages

#376: Design Systems

Tuesday, October 25, 2022

With accessible design systems, Figma kits and real-life examples. Issue #376 • October 25, 2022 • View in the browser 💨 Smashing Newsletter Dobryi vechir Smashing Friends, There is a moment in time

Meet “Understanding Privacy”, a new Smashing Book

Thursday, October 20, 2022

Meet “Understanding Privacy”, our new book on privacy, by Heather Burns. What privacy really is, beyond scary headlines. Understanding Privacy • View in the browser 💨 Understanding Privacy by Heather

#375: UX Workflow

Tuesday, October 18, 2022

With guidelines for design critique, design workshops, product design interview process, UX sketches and UX patterns. Issue #375• October 18, 2022 • View in the browser 💨 Smashing Newsletter Góðan

374: Obscure Treasures Of The Web

Tuesday, October 11, 2022

With QR codes, visualizations, dark secrets podcasts, type treasures and Mini Tokyo 3D. Issue #374• October 11, 2022 • View in the browser 💨 Smashing Newsletter Howdy, Smashing Friends! New York, New

#373: Web Performance

Tuesday, October 4, 2022

With critical CSS, encoding quality settings, resource hint validator and memory debugging. Issue #373 • October 4, 2022 • View in the browser 💨 Smashing Newsletter Salām Smashing Friends, Over the

You Might Also Like

Pierce & Ward’s Secret Sources, Business Advice You Can’t Afford to Miss, and More

Friday, April 19, 2024

View in your browser | Update your preferences ADPro “Minimalism is not my strong suit.” So says Emma Roberts, the muse behind AD's May cover story. (Celebrities—they're just like us!)

World Press Photo Contest, Speedometer 3.0, Anchor Position, Sliding Frame, Meta Llama 3

Friday, April 19, 2024

The 5 best design links, every day. Curated by a selection of great editors. Email not displaying properly? View browser version. Sidebar April 19 2024 The World Press Photo Contest Documents War,

Car UX, DevTools Tips, CSS Patterns, iOS404, Internet Cables

Thursday, April 18, 2024

The 5 best design links, every day. Curated by a selection of great editors. Email not displaying properly? View browser version. Sidebar April 18 2024 Steering the future: a new vision for car UX

Big Tents, Pistachio Palettes, and Other Late-Breaking Milan Discoveries

Wednesday, April 17, 2024

View in your browser | Update your preferences We've had a remodel! From now on, you'll be hearing from AD PRO in your inbox twice a week—once with a deep dive into trends to watch and subjects

163 / Dieter Rams inspired Framer components, America's national parks and more free resources…

Wednesday, April 17, 2024

Product Disrupt Logo Product Disrupt Half-Monthly Apr 2024 • Part 1 View in browser Welcome to Issue 163! I'm comfortable talking to a human on camera, but talking at the camera, not so much. The

Logo System, BCWA Identity, War Robots, 84—24, 19th-Century Atlas

Wednesday, April 17, 2024

The 5 best design links, every day. Curated by a selection of great editors. Email not displaying properly? View browser version. Sidebar April 17 2024 Logo System: Explore 400+ logo designs logosystem

Emma Roberts's Home: AD100 Firm Pierce & Ward Share Their Secret Sources

Tuesday, April 16, 2024

Plus, the best exterior house colors View in your browser | Update your preferences Architectural Digest AD PRO Logo exterior of two residential buildings painted with blue trim with a brick patio and

#452: Design Workflow

Tuesday, April 16, 2024

How to choose the right idea, navigate difficult conversations and communicate design. Issue #452 • Apr 16, 2024 • View in the browser Smashing Newsletter Iyi akşamlar Smashing Friends, Design workflow

Mario & Pareto, faces.js, Sleep vs Blog, Dark Mode, DOM Folding

Tuesday, April 16, 2024

The 5 best design links, every day. Curated by a selection of great editors. Email not displaying properly? View browser version. Sidebar April 16 2024 Mario meets Pareto mayerowitz.io Discover how to

Gap, Teenagers, Artistic Intelligence, Should Designers Code, CSS in RSCs

Tuesday, April 16, 2024

The 5 best design links, every day. Curated by a selection of great editors. Email not displaying properly? View browser version. Sidebar April 15 2024 Gap is the new Margin frontendmasters.com In 2020