Code Glosses — Interactive Module
Diagnose · Coach · Practice · Apply. Code glosses restate, exemplify, define, and elaborate so a reader recovers exactly the meaning you intended.
Four key functions of code glosses in academic writing
Code glosses supply additional information to make sure the reader recovers the writer's intended meaning. They are reader-oriented: every gloss is a judgement that your reader needs help here. Each function is colour-coded and tiered by academic value.
Reformulation
Say the same thing in clearer words.
The default academic reformulator — signals a full restatement.
- InitialIn other words, the effect disappears once prior attainment is controlled for.
- MedialThe model overfits; in other words, it memorises noise in the training set.
Tight, formal restatement of the immediately preceding term.
- MedialOnly content words were counted, that is, nouns, verbs, adjectives and adverbs.
Abbreviated 'that is'; keep inside parentheses in most style guides.
- MedialParticipants were novices (i.e., fewer than two years of academic writing instruction).
Useful when the first formulation was dense rather than wrong.
- InitialTo put it another way, frequency alone cannot distinguish competence from habit.
Corrective reformulation — replaces, not repeats, the earlier wording.
- MedialThe pattern is a tendency, or rather a weak statistical preference.
Draws out an implication rather than restating a term.
- InitialThis means that the two conditions cannot be compared directly.
Informal and often signals imprecision rather than clarification.
- InitialBasically, the two groups behaved the same way.
Choose the right marker
- in other wordsto put it another waywhen the whole idea needs restating for a non-specialist reader.
- that isi.e.when one term, not the whole clause, needs pinning down.
- or ratherwhen you are correcting your own formulation, not repeating it.
- basically— replace with 'in other words' or delete and write the precise claim.
Exemplification
Ground an abstraction in a case.
Neutral, highest-frequency exemplifier in academic prose.
- InitialFor example, hedging is far denser in discussion sections than in methods.
- MedialSome disciplines, for example philosophy, favour first-person argument.
Embeds examples inside a noun phrase — no comma splice required.
- MedialReporting verbs such as 'argue' and 'claim' encode writer evaluation.
Interchangeable with 'for example'; useful for variation.
- InitialFor instance, three of the twelve corpora contained no citations at all.
Abbreviated exemplifier; parenthetical use only.
- MedialFrame markers (e.g., 'in this section') orient the reader structurally.
Announces an extended example, usually a full sentence or more.
- InitialTo illustrate, consider a paragraph in which every clause is hedged.
Presents one example as especially representative.
- InitialA case in point is the sharp decline in first-person use after 1990.
Vague list-closer; the reader cannot reconstruct what was omitted.
- FinalThe corpus covers physics, biology, economics and so on.
Choose the right marker
- such asinside a noun phrase, where a full clause would be clumsy.
- for examplefor instancewhen the example needs its own clause or sentence.
- to illustratea case in point iswhen one extended case will carry the argument.
- and so on— either finish the list or write 'among others'.
Definition & naming
Fix the sense of a technical term.
Explicit, checkable definition — standard in methods sections.
- MedialMetadiscourse is defined as the writer's commentary on the unfolding text.
Lighter than 'is defined as'; fixes reference without formal stipulation.
- MedialEndophoric marking refers to any signal pointing to another part of the same text.
Attaches an established technical label to a described concept.
- MedialThe tendency to repeat an earlier structure is known as syntactic priming.
Specifies exactly which members of a set you mean.
- MedialTwo categories dominate, namely transitions and code glosses.
Stipulative — narrows a contested term to your own usage.
- MedialThe text is reader-oriented, by which I mean it anticipates specific objections.
Compact naming device, frequent in the sciences.
- MedialThis overlap region is termed the interlanguage zone.
Carries a sceptical, sometimes dismissive connotation.
- MedialThe so-called reader-responsible style is common in Japanese academic prose.
Choose the right marker
- is defined aswhen the definition must be operational and testable.
- refers toknown aswhen you are reporting an accepted sense of the term.
- by which I meanwhen the term is contested and you are stipulating your own use.
- so-called— readers hear distancing; use 'known as' if you accept the term.
Elaboration
Add a qualifying detail in passing.
Zooms in on the most relevant part of what was just said.
- InitialIn particular, the effect is confined to the postgraduate subsample.
Replaces a general claim with a precise one.
- InitialSpecifically, three of the seven measures reached significance.
Signals that the previous formulation was approximate.
- InitialMore precisely, the correlation holds only for texts over 500 words.
Embedded intensifier that singles out a case.
- MedialNovice writers, particularly those trained in Arabic rhetoric, over-signal addition.
Adds partial membership detail without closing the set.
- MedialSeveral disciplines, including law and history, resist nominalisation.
Presumes the reader's agreement and can read as condescending.
- InitialObviously, the sample size limits generalisation.
Choose the right marker
- in particularparticularlyto foreground one member of a set already introduced.
- specificallymore preciselyto replace a vague quantity or scope with an exact one.
- includingwhen the list is deliberately incomplete.
- obviously— if it is obvious, state the point; if not, argue it.
Glossing strength & placement
Every gloss is a claim about what your reader does not yet know.
- Gloss technical terms once, at first mention, and then use them confidently.
- 'Such as' inside the noun phrase keeps examples subordinate to the claim they support.
- A definition plus one example is far more effective than two definitions.
- Glossing ordinary vocabulary implies the reader is a novice and slows expert readers down.
- Chains of reformulation ('that is … in other words …') signal that the first formulation failed.
- 'And so on' and 'basically' gesture at content instead of supplying it.
A gloss must sit next to what it glosses; separated by a clause, the reader has already moved on.
Short glosses go in parentheses or between commas; extended illustration deserves its own sentence.