check for ‘code words’ – revising your writing

It is not uncommon for doctoral writers to get supervisor feedback saying they need to unpack an idea. But what does this unpack really mean – and how does a writer get in a situation where they have something that needs to be unpacked?

Well. Let me start with the last question first of all. How do we end up needing to unpack? Yes we, because it’s not just doctoral writers who get in this situation.

When we write we often begin with a half formed thought. That thought becomes an idea when we either speak it aloud or put it into words through writing. We take the idea for a walk, if you like, by putting it into spoken or written language.

And when we write our idea for the first time, say in a free writing session or as a note or a jotting, we write it for ourselves. Even if is in a first draft, we are the people who will read it. Then we work on it, process it some more.

When we are our own reader, when we write for ourselves, we often use a personal short-hand. In writing our new idea we refer to other ideas that we have developed earlier and/or to debates, other texts that we’ve read. Sometimes this early writing for ourselves uses words that we take for granted. This shorthanding is efficient, according to writing scholar Linda Flowers, because after all, it is the new idea we are working on, not old ones.

But when we switch to writing for others, we often carry these bits of short-hand over into the new text – the writing we are now doing for other readers. We forget that we have to explain terms that we understand well. We assume that because we know these words, others will also understand them, and the ways in which we use them. We are writing in way that we find natural and familiar – but others aren’t so lucky.

Linda Flower and John Hayes talk about writing shorthand terms as the use of ‘code words’. They say that we think in ‘rich bits and codes’ which all ‘need to be pushed from thought to language’. And then made clear to others.

Code words are by definition known to the writer. Code words are often idiosyncratic, their meanings can’t be easily guessed and/or they refer to an idea which could be interpreted in many different ways.  Code words stand in for complex ideas, positions taken on key debates, and/or synthesis of ideas from other writers.

It is very often our code words that need to be unpacked. Most of us are of course aware that we need to define key terms, but key terms may not be the same as code words. Code words are slippery little so and sos and can easily slip past us.

Code words need to be translated. Readers do not, cannot, know what is in the writer’s head.  But they don’t need the writer to produce an encyclopaedia entry for an explanation, the reader needs just enough to get the drift of what the writer means.

Flower and Hayes suggest some strategies for finding code words. I’ve paraphrased their strategies and made them more my own – but you know, cite here. Adapted from Flowers and Hayes (1977, yes an oldie but still helpful).

So, find code words by:

  • Asking a trusted friend to read your draft and point out the words that seem to be important but are not explained
  • Pretending you are an editor reading your text for the first time and highlight words that seem to encapsulate an important concept or signal a move in an argument. Then look to see how many of these words are actually explained.
  • Reading the paper aloud to see if any words jump out as being inadequately explained. Is there a point where the paper doesn’t seem to flow? Perhaps the problem is the use of one or more code words.
  • Highlighting any key words in your writing that seem to you to be the key to unlocking an idea. Then look to see if there is an adequate justification for its/their use. Are there adequate references out to other texts and/or a logical sequence of explanatory steps?

Flower and Hayes also offer three strategies to unpack code words. They suggest :

  • mind mapping helps to tease out the various elements of the code word. After completion, the mind map can be sorted into a writing outline.
  • writing a paper which shows how how the writer developed their understanding of the term.  Rather than a paper, I’d suggest that a tiny text or powerpoint slide or an outline might be enough.
  • going to a trusted friend, and ‘teaching’ them a way to understand your code word.

And there you are.

Code words. One possible interpretation of what ‘unpacking’ might mean.

Flower, L. S. and Hayes, J.R. ( 1977) Problem-Solving Strategies and the Writing Process College English, Vol. 39, No. 4, pp. 449-461.

Photo by Markus Spiske on Unsplash

About pat thomson

Pat Thomson is Professor of Education in the School of Education, The University of Nottingham, UK
This entry was posted in academic writing, code words, revision, revision strategy, unpacking and tagged , , , , . Bookmark the permalink.

3 Responses to check for ‘code words’ – revising your writing

  1. Jane S says:

    “Code words are by definition known to the writer. Code words are often idiosyncratic,” and “stand in for complex ideas, positions taken on key debates, and/or synthesis of ideas from other writers.” Yup. Code words are an academic shorthand; they signal to one’s imagined reader, ‘Hey, I know this, and you do, too, so we won’t waste time (and word count) explaining at wearisome length’? A major sticking point for me. Revising my thesis, and defining its terms, has begun to morph into a massive re-write. I see my voice fading, too ~ I’m concerned the project is dwindling into a ‘Janet & John’ guide to my topic.

    On the other hand, the more obscure one’s material the more it probably requires clarification. But, as the finish line approaches, anxieties about finding a balance between elucidation (i.e., simplification) and being perceived to insult the ‘Expert in the Field’ appointed to examine are fuelling a fear of failure 😦

    You’re right, Pat ~ the problems aren’t confined to the academic community. While journo, creative or entertainment media writers can adopt all sorts of tricks to convey meaning, such subterfuges are not available to doctoral candidates. The quasi-scientific processes of thesis composition will unerringly zoom in on glaring weaknesses, both in thinking and expression of a writer’s ideas. However, I *do* occasionally wonder if some impenetrably dense academic writing is nodded through because no one wishes to acknowledge they don’t understand, and assume this is their own lack and not the fault of the writer?

    Liked by 1 person

    • pat thomson says:

      Yes and it sounds like I could write another post here. Examiners don’t want the Janet and John Guide so it’s about getting that balance between explaining just enough but not too much.


  2. Lisa Kane says:

    I suddenly got a rush of gratitude for your blog and felt it was time to let you know. Somehow the posts come at the perfect moment.

    Liked by 2 people

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s