“In the event of learning content containing erroneous information, you are able to communicate this accordingly, by means of the commentary function, directly within the learning content.”
Wow – that’s a really horrible sentence.
It’s 27 words long, which is bad enough. But it also contains a high number of vague, difficult, irrelevant or frankly pompous words.
It’s part of the introduction to an online training package, which doesn’t fill me with hope. And it’s such an easy phrase to get right, that they seem to have put a lot of effort into making it so vile.
Let’s take a closer look:
In the event of - What’s wrong with the word ‘if’?
learning content – Well, it’s a training package, so it’s all learning content. We might be able to get rid of this entirely – which would be good, because it’s a bit of an empty phrase anyway.
erroneous information – Or ‘mistakes’ as they are commonly known.
you are able to – Simply saying ‘you can’ would be a good alternative. After all, why use 4words, where 2 would do?
But it would be even better to give clear directions, rather than letting people know what they ‘can’ do. The word ‘please’ would work well, and then we’ve managed to cut down from 4 words to 1.
communicate this – Tell? Report this? Even ‘notify’ might be better. Plus, who should we ‘communicate this’ to? The sentence doesn’t tell us anything about who to tell about mistakes, just how to tell them.
accordingly – This adds nothing at all – so let’s cut it.
by means of - There are several better alternatives, including ‘by using’ or ‘through’ or ‘with’.
the commentary function – This is a bit jargony, but it does relate to a specific thing called the ‘commentary’ function, so we’re going to leave it in.
directly within the learning content – The commentary function on this package is *only* available when you are looking at ‘learning content’, so this is redundant information.
Whoever wrote this horrible sentence might have been worried that people wouldn’t know where or what the commentary function was. But simply telling them that it is ‘directly within the learning content’ isn’t much of a help.
It would be better to add a new sentence that provides a link to the additional information.
So – we can get rid of that complicated 27 word sentence and swap it for this one, with 14 words;
“If you spot a mistake, please use the ‘commentary’ function to let us know.”
I’d also add a sentence before and after, so we end up with something like this…
“We try to make sure that the information in this training package is as accurate and up-to-date as possible.
If you spot a mistake, please use the ‘commentary’ function to let us know.
You can find out more about the ‘commentary’ function in the user guide.”
There. Isn’t that better?