5 exercises — practise colons, semicolons, em-dashes, the Oxford comma, and hyphens in technical documentation and IT communication.
0 / 5 completed
1 / 5
Which sentence correctly uses a colon before a list in technical documentation?
A colon before a list requires a grammatically complete clause before it. Option B is correct: "The API supports the following methods" is a complete sentence. Option A is wrong because "supports:" interrupts the verb-object relationship — the colon splits the verb from its object. Option D has the same problem: "are:" splits the linking verb from its complement. Use "the following" or "as follows" to create a complete introductory clause.
2 / 5
Which sentence best uses a semicolon to join two related independent clauses in a technical context?
Option A correctly uses a semicolon with a conjunctive adverb ("however") to connect two complete independent clauses — each side can stand alone as a sentence. Option B uses "but" after a semicolon, which is incorrect; coordinating conjunctions (but, and, or) follow a comma, not a semicolon. Option C has a fragment after the semicolon ("tests failing in staging" is not a complete clause). Option D uses a semicolon before an infinitive phrase, which is wrong.
3 / 5
A tech writer is adding an aside to a sentence in a PR description. Which version uses punctuation most appropriately?
All three options are grammatically correct; the difference is rhetorical. Em-dashes (—) create the strongest interruption and add emphasis — suitable when the aside is dramatic or pivotal. Commas create the lightest, most neutral pause — standard for non-restrictive relative clauses. Parentheses (round brackets) signal the information is supplementary or technical detail the reader may skip. In PR descriptions and documentation, all three forms are acceptable; choose based on how prominently you want to feature the aside.
4 / 5
Which sentence correctly applies the serial (Oxford) comma in a technical context?
The serial comma (before the final "and" in a list) is strongly recommended in technical writing because it prevents ambiguity. Compare: "The services are authentication, logging and error handling" — does "logging and error handling" form a single combined service or two separate ones? The Oxford comma removes that ambiguity: "authentication, logging, and error handling" clearly lists three independent items. Option C incorrectly uses a colon after "requires". Option D uses semicolons, which are reserved for lists where the items themselves contain commas.
5 / 5
Which phrase correctly hyphenates a compound adjective before a noun in technical writing?
Compound adjectives before a noun are hyphenated: "real-time" and "data-processing" each function as single pre-modifying units, so both are hyphenated when placed before "system". Without hyphens, "real time data processing system" is a five-noun stack with no visual grouping — ambiguous and hard to parse. "Realtime" as one word is sometimes seen in informal developer writing but is not standard in technical documentation. Rule: hyphenate compound adjectives before the noun; drop hyphens after a linking verb ("the processing is real time").