O'Reilly logo

The Oracle Way to Consulting: What it Takes to Become a World-Class Advisor by Kim Miller

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

CHAPTER 20

The Importance of Language

It doesn’t matter how good the content is if it isn’t written in a clear and concise way. One of the easiest tests is to read what you have written out loud to someone, even if it is your dog (dogs are great listeners but not so great at providing objective feedback). When they read their own documentation, most people tend to skip over parts without realizing that they are doing it so that it makes sense. Reading it out loud forces you to read every word and ensure that it is clear.

There are some words that should be avoided in writing documents. Any words or phrases that indicate disaster or blame should not be used:

 “You will miss your live date.” Instead try, “The priority 1 issues 23, 26, and ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required