Grammar Rules for Abbreviations and Acronyms in IT
5 exercises — mastering a/an before acronyms, plural forms (VMs not VM's), possessives, first-use conventions, and compound abbreviations like CI/CD.
0 / 5 completed
1 / 5
A developer is writing documentation and types: "We deployed ___ API gateway to handle all incoming traffic." Which article is correct?
An is correct. The rule for articles before abbreviations and acronyms is: use the article that matches the pronunciation of the first letter, not the first letter itself. "API" is pronounced letter by letter: AY-pee-eye — the first sound is a vowel sound (/eɪ/). Therefore, use an: "an API gateway", "an SQL query", "an HTTP request". Use a before consonant sounds: "a REST API", "a URL", "a UUID" — wait, "URL" is pronounced you-are-ell, starting with /j/, a consonant sound, so: "a URL". Test: say the abbreviation aloud; if the first sound is a vowel, use an.
2 / 5
A team member writes: "We have three VM's running in the cluster." A colleague says this is wrong. What is the correct plural form?
VMs (no apostrophe) is correct. In modern technical writing, the plural of an acronym or abbreviation is formed by simply adding s — no apostrophe. An apostrophe in VM's creates a possessive, not a plural: "The VM's CPU usage is high" (the CPU of the VM). Common correct plurals: APIs, URLs, VMs, PRs, CIs, IDEs, DBs. The outdated style of API's for plurals still appears but is incorrect in contemporary style guides (Chicago, AP, Microsoft Writing Style Guide). VMes is not a real form. The rule: apostrophe = possessive; no apostrophe = plural.
3 / 5
A technical document states: "The _____ response was malformed." The blank refers to the application programming interface. Which form is correct the first time this term appears?
API (application programming interface)'s is the correct first-use possessive. Best practice: introduce the full term with the abbreviation in parentheses on first use, then use the abbreviation alone thereafter. The possessive is formed with 's appended to the abbreviation: "The API's response was malformed". On first use in formal documentation, write: "The application programming interface (API)'s response" or rephrase to avoid the awkward construction: "The response from the API was malformed." Option A lacks the full term on first use. Options C and D repeat the full term in the wrong position or format.
4 / 5
Which sentence correctly uses the article before the acronym SQL?
Both "a SQL" and "an SQL" are acceptable. This is one of the most debated article choices in technical writing. "SQL" can be pronounced two ways: (1) as letters ess-cue-ell (vowel sound → an SQL); (2) as a word "sequel" (consonant sound /s/ → a SQL). Both pronunciations are in widespread professional use. Many style guides (including Microsoft) accept both. Teams should simply pick one convention and be consistent. Unlike "API" (always an) or "URL" (always a), SQL sits in a genuine grey area. The broader rule remains: article choice depends on pronunciation, and when pronunciation is split, both forms are defensible.
5 / 5
A commit message reads: "Fix the CI/CDs pipeline configuration." What is grammatically wrong with this sentence?
"CI/CD" is a compound abbreviation treated as a single unit modifier. When used attributively (before a noun), it is not pluralised: "the CI/CD pipelines" (plural comes from the noun, not the modifier). Writing "CI/CDs pipeline" pluralises only half the abbreviation, which is incorrect. Compare: "REST APIs" (REST modifies APIs, so APIs is pluralised), vs "CI/CD pipelines" (CI/CD is a compound modifier that stays invariant). Other correct uses: "our CI/CD workflows", "multiple CI/CD configurations". Never write "CIs/CDs" or "CI/CDs" as plurals of the compound.