Salesforce Style Guide for Documentation and User Interface Text
jJargon and Cliches
Avoid jargon and cliches, which are words and phrases that have
become trite and ineffective through overuse. Here are some examples:
- Cutting edge
- Ease of use
- General-purpose
- Grow your business
- Hands-on
- Innovative
- Intuitively
- Leverage (as a verb)
- Paradigm
- Powerful feature
- State-of-the-art
- Robust
- User-friendly
- Total solution
- Translate technical jargon into simple words whenever you can. Even when the reader is highly skilled, plain English may still do the best job of communicating. When you cannot use simple words, define or explain them.
- If technical terms are appropriate and necessary for your audience and purpose, make sure they're defined clearly and used consistently.