General writing tips
- Front-load important information and write for how much
people want to read
Users read a given amount of text after which they only scan for seemingly important phrases or words. Include important information up front and only write as much as users are willing to read.
- Use lists when needed
Any sentence containing 3 or more items separated by a comma should be turned into a list.
- Format long-form content properly
Make long-form content more scannable with structural elements (labels, headers).
- Don't use "here"
Embed your links in clear, descriptive language.