Skip to main content
Tag

Plain English

Technical writing using S.C.O.T.T.

technical writing scott keyser

On the 28th of July, I ran my first live event on WebinarJam – a one-hour webinar on how to give your technical writing more impact. It included five writing techniques for technical professionals. We had about 90 attendees. If you were one of them, thank you so much for joining us. I loved doing it. It was such a buzz.

Technical writing confidence

We kicked off the webinar with a poll. I asked people to plot their confidence in their technical writing on a scale of one to ten. It was a very typical bell curve distribution, with the rump of people landing between 4 and 7 on the confidence scale. There were no 10s. This is what I would have expected. I guess you could say that anyone who rated themselves a 10 wouldn’t need to be on the call.

Then I shared with the webinar group a really horrible piece of writing. It was a 200-word piece of corporate gobbledygook, as I like to call it. We dissected it. I colour-coded various issues, like Nounitis, Passivitis, long sentences, wording…so that the whole thing was just a riot of highlighted colour.

Then we scored its readability. Actually, according to the readability stats in Word, it scored a Zero. It was pretty damning. What I proceeded to do with the group was rewrite it, using my Big Five Writing Techniques.

That took the readability from 0 to just under 74 per-cent. When we used the Flesch Reading Ease score, the contrast was stark.

Confidence, round two

Then we ran a second poll. I say “we” because I was assisted technically by a great guy called Ben Smith, who’s an expert on WebinarJam. To be honest with you, without his help, I don’t think it ever would have happened. He ran all the behind-the-scenes technology, which was great. I just showed up with the content.

In that second poll, we asked people to plot their confidence again. This time, the overall ratings went up. There were far fewer people in the 2-to-3 and 4-to-5 brackets and many more in the 6-to-7 and 7-to-8 brackets. I think there were even a couple of 10s as well.

That was amazingly gratifying to me, to see that in the space of an hour, we were able to boost people’s confidence in their writing.

The Big Five Writing Techniques

Next, I shared with the group the Big Five Writing Techniques that I had applied. I also imparted a new acronym to help them remember those five techniques.

That acronym?

S.C.O.T.T.

  • Shorten Your Sentences. Your ASL (Average Sentence Length) should be 15 to 20 words.
  • Cure Nounitis with Verbitis. Nounitis is the overuse of nouns, and we cure that using more verbs than nouns.
  • Omit Needless Words and Phrases. Remove any redundant, needless or unnecessary words and phrases that are not adding any value, content, meaning or information.
  • Turn Your Passives into Actives. Many people are not aware of the difference between the two. As a result, a lot of people (and you may be one of them) write unconsciously in passive voice.
  • Trust in Plain English. That’s the best way to simplify your writing and your language. Don’t equate plain English with dumbing down your writing. The two are very different. Using plain English is about making your language simpler – as opposed to making it simplistic, which is bad. Simplistic means dumbing down and undermining the intellectual rigor and the quality of your content. That’s the last thing I want you to do.

A technical writing offer

Finally, there was a simple offer at the end of the webinar – to jump on a discovery call with me. It’s a no-obligation, non-threatening, relaxed way to get to know you and your writing, for people who might want to explore different ways of working with me and engaging me. Only a few people took me up on that offer, but the whole experience was just brilliant.

I loved sharing my S.C.O.T.T. acronym with people. I’m on a roll, and I can’t wait to do my next live event.

I may also run a writing clinic, where I just show up and you can ask me anything you want about writing. It can have to do with planning, drafting or editing. It can be about one of my 21 writing techniques, editorial policy or how to write winning bids and tenders. Maybe you have questions about pitches, proposals or sales letters. Absolutely anything. I welcome all-comers. If I can’t answer your questions there and then, I will get back to you with an answer within 72 hours.

I think that will be my next gig, and you will be the first to hear of it.

S.C.O.T.T. for all kinds of technical writing

What does S.C.O.T.T. mean for you and your writing?

The acronym S.C.O.T.T. represents the Big Five Writing Techniques that are guaranteed, without exception, to improve your readability if you apply them properly. That may sound like a bold statement, but I stand behind that. Use them in your technical writing, and you will notice a marked improvement in your results.

I am Scott Keyser, The Writing Guy, helping smart professionals to find their voice, write human and change the world with their words. I invite you to browse my Write for Results blog to learn more about how to further improve your technical writing (and all types of writing for that matter). And if you like to absorb your information in audio format, don’t forget about The Writing Guy podcast.

How to double your readability score

readability scott keyser

The other day, I spoke about a webinar that I ran for a client. I had sent them a very short paragraph written in corporate gobbledygook, and their mission—should they have chosen to accept it—was to rewrite it in plain English. That meant using simple, jargon-free language. Using the readability stats in Word, everybody, without exception, managed to double their readability as measured by the Flesch reading ease score. In Kelly’s case, her results were simply stunning.

So what I’d like to do is share with you her original rewrite, along with its readability score. Then I’ll share her ultimate version, with amazing readability.

 

Kelly’s paragraph, with low readability

This was Kelly’s original rewrite:

‘We’re excited to create our new e-business strategy. And we’d like to get your ideas on how we can shape our new strategy.’ (So she changed the tone of voice a little bit, quite rightly trying to make it more inspirational and direct using ‘you’ and ‘your’, in second person singular. Then she goes on to write…) ‘To help inspire you, our objective is online innovation, supporting profitability, customer acquisition…and brand enhancement must continue to drive what we do. We must also set clear targets that are achievable, and demonstrate our capabilities’. I like the beginning of that, where she’s using a contraction. ‘We’re excited to create our new business strategy and we’d like to get your ideas’. So that’s nice and human and conversational, but then to my ear, at least, it sort of lapses into a kind of management-speak with ‘online innovation, customer acquisition and brand enhancement’. And then she talks about ‘demonstrating our capabilities’ which is not really plain English.

Now, when we score the readability on that, her average sentence length (ASL) was just within range at 19.6 words, but her average characters per word ran to 5.1 which is a little bit too high. That immediately indicates to me that she’s using needlessly formal, polysyllabic words. As a result, her readability score was only 36%.

So we worked on it together, just for a few minutes, proving that this stuff is so easy. You know, writing with impact, writing concisely, writing with personality and power is not rocket science. This is a learnable skill.

 

Doubled readability in Kelly’s revision

Here is Kelly’s revised version:

‘We’re excited about creating a new e-business strategy and we’d like your ideas to help shape it. To help you, our main goal is online innovation. That will help you to win new customers, build your brand and make more money. Hitting these targets will show that we have the right mix of skills.’

So I slightly changed just a couple of the words there but you get the idea. It’s shorter. It’s more concise. We’ve kept the the contractions, which renders it conversational and human. And in fact, that first line has got quite a nice rhythm to it. ‘We’re excited about creating our new e-business strategy and we’d like your ideas to help shape it.’ There’s a bit of a rhythm there. And then we’ve got a short sentence ‘To help you, our main goal is online innovation’. Okay, full stop. ‘We’d like you to focus…’ Because she used the word focus which is a S.O.W. (Severely Over-used Word), I just replaced that on the hoof. ‘That will help you to win new customers…’ here we have verbs, including ‘build’ and ‘make more money’.

So can you hear that? Hear the difference between ‘supporting profitability, customer acquisition and brand enhancement…’ in the first version? ‘To win new customers, build your brand and make more money’? You know, it’s plainer English. It’s simpler and more powerful. Much easier to read. 

We decided to launch the last sentence with a gerund, which is a verbal noun: ‘Hitting these targets will show…’, rather than ‘demonstrate’. ‘Show’ is one syllable, ‘demonstrate’ is three syllables. Use the simpler word: ‘Hitting these targets will show that we have the right mix of skills’, rather than ‘We must also set clear targets that are achievable and demonstrate our capabilities.’

 

The overwhelming readability preference

Don’t know about you, but I certainly know which style of writing I’d prefer to read. That later, ultimate version that Kelly created had an average sentence length of 14 words, which is brilliant. Average characters per word dropped from 5.1 to 4.5 because she started using simpler, shorter words and simpler language. As a result of that, we doubled her readability. It went from 36% to just under 72%, which is well within plain English.

Hats off to Kelly, who just showed how easy it was, with brilliant results. I would say we did that in a total elapsed time of 10 or 15 minutes. That’s how easy this stuff is! I really want to impress upon you that the ability to write with impact, power and personality is an eminently learnable skill that is within everybody’s gifts. So on that note—that hopefully inspiring note—I’m going to leave it there for now.

Thank you, Kelly, for being a brilliant delegate. 

This readability article has been taken directly from Episode 146 of The Writing Guy podcast. Please have a listen if you’d like.

 

I’m Scott Keyser, The Writing Guy, helping smart professionals to find their voice, write Human and get the results they want from the words they write. Interested in transforming your writing? Then please get in touch for a relaxed, no-obligation chat with Scott. Simply send an email to scott@writeforresults.com.

Dancing with words: a sign of intelligence

sign of intelligence scott keyser

As human readers and writers, we’re always looking for a sign of intelligence in making decisions. Whom to read, whom to hire, whom to contract…the list goes on. How do we do that? What are the criteria and are we even aware of them?

Yesterday I had a NeuroKinetic Therapy™ (NKT) session with a therapist called Sue (for a sports-related knee injury). NKT addresses musculo-skeletal problems by getting the whole body working and moving in balance and harmony.

I always come out of Sue’s sessions feeling and moving better than when I went in; I literally skip home. That got me thinking about fluidity, fluency and flow, both physical and mental. When we see somebody walking, running or dancing — activities demanding physical co-ordination — we can see at a glance whether they’re moving well, with grace, elegance and ease, or whether they’re moving badly or with difficulty.

It’s the same with writing.

Within a few moments we know if we’re in the hands of an artist or an amateur. If it’s well written, our eyes flow across the lines and down the page, assimilating the meaning of the well-chosen words and merging with the rhythm set by the writer. Fluency and flow make it easier to decode and process the words. Our perception of the message and the messenger are positively influenced. We find the sign of intelligence we were searching for.

On the other hand, if the writing is clunky, clumsy and hard to process — all too common in B2B writing — the reader won’t hang around for long. Most business readers are unforgiving, abandoning this type of writing sooner than you can say ‘plain English’. Losing your reader = communications failure.

Sign of intelligence:  a study

The search for a sign of intelligence isn’t just about the language.

A 2005 study conducted by Daniel Oppenheimer among Stanford University graduates found that visual disfluency caused by poor choice of font or typographic style lowered their perception of the author’s intelligence. So the content of your writing is just one of a kaleidoscope of elements — including font, point size, leading (line spacing), page grid, line length and graphics — that need to function in concert to move the reader both intellectually and emotionally.

This doesn’t happen by chance. Though writing well is neither an innate gift nor a Ninja-style black art, but a learnable skill…it still has to be learnt. The craft has to be mastered.

As I skipped home from my therapy session thinking about the connection between writing and movement, I recalled the words of one of the greatest writers ever to grace the English language:

“True ease in writing comes from art, not chance,
As those move easiest who have learn’d to dance.”

Alexander Pope, An Essay on Criticism

Are your business communications answering the call for a sign of intelligence? Or are they missing the mark? Find out by learning about plain English, writing human and much more as I walk you through how to win bids and tenders, nail your pitch and transform your writing. It’s all on my website, writeforresults.com.