Foundation
Content design
Tone of voice
8min
highly recommended following the guidelines for tone of voice is encouraged as it will improve the user experience for all texts clear text should leave little room for question or doubt ideally a user could skim and grasp enough of the text to keep moving on with their work and if they do read the text more closely, they should only have to read it once to understand text should be understandable to people with all levels of experience helpful if the user is in a jam, our text should provide a way out if it’s informational text, it should give useful, actionable instruction or info remember that your user may not have the same expertise as you, so they will not know the same technical info as you do friendly don’t be robotic or technical imagine you’re having a polite, professional conversation with your reader consider what state a user may be in if they may be stressed, get to the point but with a softer tone if they may be excited, write positively and a little more upbeat! concise if you can cut out any words, do it! fewer words are almost always better except when it comes at the cost of losing clarity do not include unnecessary information if you think there may be info that some users may be interested in knowing, add a “show more” section tool names unique always check for similar terminology in cet and in the industry before naming a new tool consult the internet and/or subject matter experts to find out if a term is already used, or if it means something else in the industry consistent names should be used across the whole platform and community so choose a good name early on that will get passed along all the way to users, so that everyone can be on the same page as much as possible, we want to avoid having a developer name and a user name for things design principles always keep our design principles docid\ zxwxntbfvf1ktbscjutn9 in mind! empathy simple familiar empower