Tricky Grammar in User Guides
![ClickHelp Team](https://clickhelp.com/wp-content/uploads/2024/04/ClickHelp-Logo-Logo-only-Full-color-no-space@2x.png)
All technical writers are famous for being meticulous about grammar, style, and punctuation. Reviewers and editors are even more scrupulous. If we count the time wasted on checking grammar in user guides, it will probably drive us to the conclusion that this is one of the most important parts of the process. Wait, what?… Did I just say ‘time wasted on checking grammar’? I did, yes. Well, you see, technically, the main aim of technical writing is to deliver a clear message to their audience, not just produce grammatically correct technical texts. Let me explain further how proofreading can become a time-devouring monster that will interfere with your best-laid help authoring plans. And, hopefully, at the end of this blog, you will learn how to fight it.
They say we live in a focus-based universe. I find it hard to argue with that. Creating a tech writing project can be a great example here – while you are focusing on how grammatically correct things are, you are forgetting about other crucial things, letting them slip away. You are too focused on smaller stuff to see the bigger picture. This is why grammar should not be placed on a pedestal of technical writing.
I bet you know a lot of grammar and punctuation rules and this is awesome. And, I am sure that you are still learning or revising things. Especially when you are creating technical texts not in your mother tongue. But try thinking about all the times when you put the writing process on hold to get a very specific grammar rule from Google and that took you more time than you are ready to admit. Sometimes, procrastination is to blame – who doesn’t like googling ‘important things’ when they actually have a help topic to write. But, there’s one more possible reason for this behavior – inability to evaluate how important a grammar rule is. This might sound blasphemous, but hear me out.
All grammar and punctuation rules can be broken down into two categories: essential and non-essential. If you accept this concept, you will see that some rules are not worth worrying about. How do you differentiate? We can’t take every single grammar rule and just put it into two columns for reference. So, we’ll need to get creative. Here are some things that point to the fact that a rule is essential:
Non-essential rules are the opposite of everything mentioned earlier – they do not distort the message and are often just acceptable variations of one thing. A couple of examples to explain what I mean:
There’s some truth in it.
There’s some truth to it.
Both mean that something is partially true. If you dig deeper, you might find out that there’s a slight difference which wouldn’t really matter if you decided to use either of the prepositions in your text.
Now that we got rid of this grammar craze and freed up some precious time, it should be put to good use. We’ve focused enough on details – it is the right moment to take a step back and see the whole picture. Use this opportunity to make sure you are on track with the bigger goals!
Good luck with your technical writing!
ClickHelp Team
Author, host and deliver documentation across platforms and devices
Get monthly digest on technical writing, UX and web design, overviews of useful free resources and much more.
"*" indicates required fields