Content Guide
API Guidelines
- Semantic consideration when formatting content, especially when choosing a header. For more information refer to the training video on headers.
- Use &, not 'and', as in Oil & Natural Gas
- Use fullsize, not 'full-size', apply for all compound words.
- – (ndash), not '- (hyphen)' or '— (mdash)' to indicate a range, without spaces.
Google Guidelines
Please refer to Google's guideline for writing content, a fascinating read on appropriate language for apps and the web.
Quick reference below:
- Speak to the user as “you”
- Don’t refer to “we”
- Be concise
- Use simple word forms
- Write in the present
- Write simply and directly
- Use simple words that everyone knows
- Omit unnecessary phrases
- Use consistent verbs across the arc of an action
- Lead with the goal, not the method
- Never say “never”
- Be friendly, respectful, and focus on the user
- Be humble
- Be positive
- Be essential
- Avoid exclamation points!!!!!!!!!