Using jargon

I work in a technical field. Is it okay to use jargon?

If you’ve ever been trained in plain English or professional writing, you’ve probably been told to avoid jargon at all costs. However, I think there’s room for more nuance. First, let’s look at the definition of jargon.

The Macquarie Dictionary has three main definitions of jargon:

  1. the language peculiar to a trade, profession, or other group
  2. pretentious language characterised by the use of uncommon or unfamiliar words
  3. unintelligible or meaningless talk or writing; gibberish.

It’s clear that writers of any sort should avoid definitions 2 and 3. Good writing should be easily understood by your audience, and pretentiousness has no place in it. Even academic writing, where pretentious language is often used as a supposed marker of intelligence, is thankfully now moving much more towards plain language and accessibility.

But what about definition 1? This is where audience becomes important.

Technical or profession-specific language is not a problem in and of itself. Often it provides nuance that gets lost when simpler terms are used. What matters is your audience. If you’re writing for other professionals in your field, you can use more technical language and know that you’ll be understood. However, if you’re writing for a general audience – on a website, for example – you need to use language they will understand. Often this means swapping technical terms for more commonly understood words, and checking for any assumed knowledge. This isn’t ‘dumbing down’; it’s meeting your audience where they’re at. In some fields, such as public health, doing this well can literally be the difference between life and death. In others, such as law, where there’s a growing push for the use of plain language, it impacts important things like informed consent.

With any writing, the first thing you should ask yourself is ‘Who am I writing for?’. Your answer to that will determine whether or not jargon is acceptable.

Improving your self-editing

What skills should I develop to get better at editing my own work?

Great question. You might expect me to say something like ‘spelling, grammar, and punctuation’, but actually the skills that I think are most important for an editor (or even for someone who just wants to get better at self-editing) aren’t writing-related at all. In my opinion, the top three skills that all good editors cultivate are curiosity, empathy, and attention to detail. Let me explain.

Curiosity

Good editors are fundamentally curious. They have a wide-ranging general knowledge (often in addition to a speciality) and they love adding to it, learning about new subjects, and putting pieces together. This is important, because a major part of editing is looking critically at a document and being aware of when things may not be quite right – when they need to be fact-checked, referenced, or referred to a specialist (such as a lawyer or accountant) for further advice.

Once you get into the habit of reading critically, you start to develop intuition about the types of things that need to be checked. Editors of historical fiction, for example, will know when something sounds anachronous to the time period the book is set in. In my field – government, business, and professional associations – I try to have a good sense of what’s going on in the wider world, because the documents I edit often refer to politics, international affairs, and societal issues such as public health or climate change, and these can change quickly.

My aim is to learn something from every document I work on, and it’s amazing how often I apply that knowledge to subsequent projects. Learn to read your own work critically, ask why, and be curious about the world, and your self-editing will improve substantially.

Empathy

No matter their field, a good writer knows their audience. And a good editor can get out of their own head and into the mind of that audience, to think about whether they’ll understand what the writer is trying to communicate. This means developing empathy with audiences whose experiences may be very different from your own (e.g. people whose first language is not English, or people with disability).

One of my editorial bugbears is when I point out to a writer that their work may have accessibility problems due to the way it’s presented or written, or even due to something as simple as using two spaces rather than one after a full stop – and the writer chooses to ignore it. This shows a lack of empathy with their audience and suggests they don’t care that they may be making life harder for their readers. If you want to get better at self-editing, learn to look at your writing – language, tone, structure and formatting – from outside the lens of your own experience.

Attention to detail

In some ways this one is obvious – a good editor needs to be able to spot things like errant punctuation, or the fact that one paragraph has 9pt line spacing while the next one has 3pt. But attention to detail is about more than this. It ties in closely to curiosity. In my field, attention to detail means seeing a reference to ‘Council of Australian Governments’ and knowing that COAG was disbanded in mid-2020. For a fiction editor, it might mean tracking down the etymology of a particular word to check if it would have actually been used in that context. Individually, these are small things, but collectively they can make or break a piece of writing. Paying attention to the little things will vastly improve the quality of your writing.

Like any skill, these three can be developed with practice. The more you use them, the easier it will get, and the better your writing will become. And they will also serve you well if you find yourself in a position where you have to give feedback on other people’s writing.

Using ‘however’

How do I use ‘however’? Do I need a comma?

‘However’ is one of those things that people commonly trip over. The short answer is yes, you do need a comma…sometimes.

‘However’ can be used in three ways:

  1. To start a sentence that contradicts the previous one
  2. In the middle of a sentence, contradicting the previous sentence
  3. In the middle of a sentence as a new clause that contradicts the previous clause. This always needs a semicolon.

Examples of each use (note the different punctuation):

  1. Jen always wore red. However, that day she surprised me by wearing blue.
  2. Jen always wore red. That day, however, she surprised me by wearing blue.
  3. Jen always wore red; however, that day she surprised me by wearing blue.

Some purists don’t like starting sentences with ‘however’. However (see what I did there?), it’s becoming more common and is now generally accepted.