Adhering to rules of grammar and mechanics helps us build trust by keeping our writing clear and consistent. This section describes Notion’s company style, which applies to all of our content and writing, including our website, product, emails, and ads.
<aside> 💡 Check out Writing about Notion and Key Messaging for help describing products, features, and services.
</aside>
If there’s a chance your reader won’t recognize an abbreviation or acronym, spell it out the first time you mention it. Then use the short version for all other references. If the abbreviation isn’t clearly related to the full version, specify in parentheses.
If the abbreviation or acronym is well known, like API or HTML, use it instead, and don’t worry about spelling it out.
Abbreviations that are just shortened version of one word, and not an acronym or initialism that expands to multiple words, should be all lower-case.
Use the active voice. Avoid the passive voice.
In active voice, the subject of the sentence does the action. In passive voice, the subject of the sentence has the action done to it.
<aside> ✅ Jose signed into his account.
</aside>
<aside> 🚫 The account was signed into by Jose.
</aside>