Login
Toggle sidebar

Lint: how-to-use-acronyms

Contractions
error

"Acronyms are abbreviations formed by the first letters or components of a word or phrase. They make life easier as a long term can be condensed into a short term that's easier to pronounce and write. No one likes to say or write "cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy", but it's no problem to say "CADASIL". Similarly, there are a number of commonly used non-medical abbreviations (e.g., i.e., etc.) that one can assume all readers are familiar with (see accepted abbreviations)."

Line 1:183 · Never use contractions: use 'that is' in place of 'that's'.

"Acronyms are abbreviations formed by the first letters or components of a word or phrase. They make life easier as a long term can be condensed into a short term that's easier to pronounce and write. No one likes to say or write "cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy", but it's no problem to say "CADASIL". Similarly, there are a number of commonly used non-medical abbreviations (e.g., i.e., etc.) that one can assume all readers are familiar with (see accepted abbreviations)."

Line 1:348 · Never use contractions: use 'it is' in place of 'it's'.

"It can be tempting to abbreviate longer terms for repeated use in the remaining text ("convenience acronyms"). This practice is widely used in medical textbooks and journal articles, stemming in large part, from word count and page number limits. Unfortunately, acronyms reduce readability and comprehension, particularly when they are unfamiliar. Thus, since we don't need to worry about word length and readers often skip down to the middle of an article, we only use abbreviations or acronyms if they are widely known and used."

Line 11:367 · Never use contractions: use 'do not' in place of 'don't'.

"Note: This is a topic of some contention and various style guides adopt different conventions. Please don't get upset by this. We have chosen this one as a common and simple option."

Line 37:123 · Never use contractions: use 'do not' in place of 'don't'.
Periods
error

"Acronyms are written with the individual (usually capital) letters forming a word, without full stops (periods) separating the letters, e.g. CMV, and not C.M.V."

Line 16:158 · Don't use periods with acronyms or initialisms such as 'C.M.V.'.
Quotes
error

"the key exception to this, is for a few accepted abbreviations in which we stipulate that full stops are used, for example "e.g." (not eg), etc."

Line 17:142 · Commas and periods go outside quotation marks (in nearly all circumstances).
Strong List Colon Position
error

"correct: AMIs, MCAs, ELSTs"

Line 24:8 · When enboldening an intro, the colon should not be bold. '<strong>correct:</strong> AMIs'

"incorrect: AMI's, MCA's, ELST's"

Line 25:8 · When enboldening an intro, the colon should not be bold. '<strong>incorrect:</strong> AMI'

"correct: SOSs"

Line 29:8 · When enboldening an intro, the colon should not be bold. '<strong>correct:</strong> SOSs'

"incorrect: SOS's, SOSes"

Line 30:8 · When enboldening an intro, the colon should not be bold. '<strong>incorrect: </strong>SOS'

"Note: This is a topic of some contention and various style guides adopt different conventions. Please don't get upset by this. We have chosen this one as a common and simple option."

Line 37:4 · When enboldening an intro, the colon should not be bold. '<strong>Note:</strong> This'
Strong
warning

"If one were being pedantic, then actually most medical acronyms in English are initialisms, as they are pronounced as individual letters rather than a word (e.g. AMI is said "a-em-eye" and not "aimee"). NASA is an example of a true acronym as it is pronounced as a word "nasa" rather than "en-a-es-a". All that having been said, most folks are now using the term acronym for both, and if you are reading this you are probably not getting invited to many parties anyway, so best to let it go."

Line 9:83 · Generally, don't use bold in text: '<strong>initialisms</strong>'

"Note: This is a topic of some contention and various style guides adopt different conventions. Please don't get upset by this. We have chosen this one as a common and simple option."

Line 37:4 · Generally, don't use bold in text: '<strong>Note:</strong>'
Acronyms
warning

"If one were being pedantic, then actually most medical acronyms in English are initialisms, as they are pronounced as individual letters rather than a word (e.g. AMI is said "a-em-eye" and not "aimee"). NASA is an example of a true acronym as it is pronounced as a word "nasa" rather than "en-a-es-a". All that having been said, most folks are now using the term acronym for both, and if you are reading this you are probably not getting invited to many parties anyway, so best to let it go."

Line 9:183 · 'AMI' has no definition. Spell it out if it's unfamiliar to the audience.

"If one were being pedantic, then actually most medical acronyms in English are initialisms, as they are pronounced as individual letters rather than a word (e.g. AMI is said "a-em-eye" and not "aimee"). NASA is an example of a true acronym as it is pronounced as a word "nasa" rather than "en-a-es-a". All that having been said, most folks are now using the term acronym for both, and if you are reading this you are probably not getting invited to many parties anyway, so best to let it go."

Line 9:242 · 'NASA' has no definition. Spell it out if it's unfamiliar to the audience.

"incorrect: AMI's, MCA's, ELST's"

Line 25:36 · 'AMI' has no definition. Spell it out if it's unfamiliar to the audience.

"incorrect: AMI's, MCA's, ELST's"

Line 25:50 · 'ELST' has no definition. Spell it out if it's unfamiliar to the audience.

"incorrect: SOS's, SOSes"

Line 30:36 · 'SOS' has no definition. Spell it out if it's unfamiliar to the audience.
Emphasis
warning

"If one were being pedantic, then actually most medical acronyms in English are initialisms, as they are pronounced as individual letters rather than a word (e.g. AMI is said "a-em-eye" and not "aimee"). NASA is an example of a true acronym as it is pronounced as a word "nasa" rather than "en-a-es-a". All that having been said, most folks are now using the term acronym for both, and if you are reading this you are probably not getting invited to many parties anyway, so best to let it go."

Line 9:196 · Italics should be used only in exceptional circumstances: '<em>a-em-eye</em>" and not "<em>aimee</em>'
EG List And
warning

"Acronyms are written with the individual (usually capital) letters forming a word, without full stops (periods) separating the letters, e.g. CMV, and not C.M.V."

Line 16:140 · An e.g. list gives selected examples, so it should not end with 'and' or 'or': 'e.g. CMV, and'.
Headings Valid
warning

Expected headings

  • H1 Terminology
  • H1 Usage
  • H1 Epidemiology
  • H2 Risk factors
  • H2 Associations
  • H1 Clinical presentation
  • H2 Complications
  • H1 Diagnosis
  • H2 Diagnostic criteria
  • H2 Diagnostic clues
  • H1 Pathology
  • H2 Aetiology
  • H2 Location
  • H2 Classification
  • H2 Macroscopic appearance
  • H2 Microscopic appearance
  • H2 Immunophenotype
  • H2 Markers
  • H2 Genetics
  • H1 Radiographic features
  • H2 Plain radiograph
  • H2 Mammography
  • H2 Antenatal ultrasound
  • H2 Transoesophageal echocardiography
  • H2 Ultrasound
  • H2 CT
  • H3 Dual-energy CT
  • H2 Angiography (DSA)
  • H2 MRI
  • H2 CT/MRI
  • H2 Nuclear medicine
  • H3 PET-CT
  • H3 PET-MRI
  • H1 Radiology report
  • H1 Treatment and prognosis
  • H2 Complications
  • H1 History and etymology
  • H1 Differential diagnosis
  • H2 Clinical differential diagnosis
  • H1 Practical points
  • H1 See also

"When to use acronyms"

Line 10:1 · "When to use acronyms" is not a recognised heading for this article type.

"How to use acronyms/abbreviations"

Line 12:1 · "How to use acronyms/abbreviations" is not a recognised heading for this article type.

"Acronym use in article titles"

Line 18:1 · "Acronym use in article titles" is not a recognised heading for this article type.

"Pluralisation"

Line 20:1 · "Pluralisation" is not a recognised heading for this article type.
Inline EG
suggestion

"Acronyms are abbreviations formed by the first letters or components of a word or phrase. They make life easier as a long term can be condensed into a short term that's easier to pronounce and write. No one likes to say or write "cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy", but it's no problem to say "CADASIL". Similarly, there are a number of commonly used non-medical abbreviations (e.g., i.e., etc.) that one can assume all readers are familiar with (see accepted abbreviations)."

Line 1:462 · Consider replacing a bracketed e.g. with an inline e.g. after a comma.