Docs Menu

Use Positive Statements

Positive statements are easier to understand than negative statements and are typically shorter.

Use
Avoid

The software works properly when installed correctly.

The software won't work properly unless you install it correctly.

Remember to involve your business users in the scheduling process.

Don't forget to involve your business users in the scheduling process.

Sometimes you want to prevent a search engine from indexing a website.

It isn't uncommon in certain situations to not want to allow indexing of a site by a search engine.

Try to avoid the following negative words, using instead the suggested alternatives, particularly in reference to the user or the company. However, always communicate honestly and transparently about issues, and accurately describe a system's performance.

Avoid
Alternative

damage

affect

catastrophic

serious

bad

Use serious or add an explanation

fail

unable to

kill

cancel

fatal

serious

destroy

remove

wrong

incorrect, inconsistent