đź“‹ Overview
đź—Ł Voice and tone
✍ Writing principles

<Principle 1>
Whenever possible, offer a solution

While it's important to be direct in error messages, it's equally important to be helpful. Avoid messaging that focuses on the problem without offering a solution or way forward:

Your password's too short
 |
Don't
 |
Instead, help the people who use your product understand why they're experiencing an error and how they can avoid similar errors in the future:

Choose a password that is at least 8 characters long
 |
Do
 |
Add Comment