5 exercises — digits vs words, percentages, ranges, version numbers, and measurement formatting in technical documentation.
0 / 5 completed
1 / 5
A technical spec states: "The API should respond within five hundred milliseconds and handle at least two thousand requests per second." Which version follows standard technical writing number rules?
Option D is correct — both A and C are acceptable. The key rule is: use digits for technical measurements. Writing "five hundred milliseconds" in a technical spec forces the reader to convert mentally. Digits (500ms or 500 milliseconds) are faster to read and unambiguous. The difference between A and C: "500ms" uses the SI abbreviation (preferred in highly technical contexts), while "500 milliseconds" is clearer for mixed audiences. For thousands: "2,000" (with comma separator) is preferred in English; "2000" without comma is also common in technical writing. Never hyphenate spelled-out numbers in technical contexts ("five-hundred" is wrong).
2 / 5
A commit message says: "Reduced query time by 40 %." What is wrong with the percentage formatting?
Option B is correct. In technical writing, percentages are written as "40%" — no space between the number and the symbol. This is the standard in software documentation, commit messages, dashboards, and reports. Note: The ISO 31-0 standard technically recommends a space ("40 %"), but this is not followed in everyday IT writing — "40%" is universal in engineering contexts. Option A is technically defensible by SI rules but not what readers expect in a code context. Option C is wrong: spelling out "forty percent" is appropriate only in formal prose for general audiences, not in technical commit messages. Option D adds spurious precision unless the measurement was genuinely 40.0%.
3 / 5
An API changelog entry reads: "Rate limits have been increased from 100 to 1000 requests per minute." Which version is better for a technical audience?
Option D is correct — both B and C are acceptable. In changelog and API documentation, always use digits for limits, counts, and capacities. The choice between "1,000" and "1000" is a style guide question: American English typically uses the comma separator ("1,000"); British English and many tech projects omit it for numbers below 10,000. Both are unambiguous to a technical reader. Option A spells out both numbers — this forces cognitive conversion and is inappropriate for a changelog. If your project uses a specific style guide (Google Developer Style, Microsoft Writing Style), follow its number formatting rules consistently.
4 / 5
A technical document describes a version range. Which is written correctly?
Option D is correct. All three formats are acceptable, but each has a preferred context. En dash (–): "3.2–4.0" is typographically correct for ranges in formal documentation and published docs. "to" in prose: "3.2 to 4.0" is clearest in prose explanations ("This change applies to versions 3.2 to 4.0"). Hyphen (-): "3.2-4.0" is common in code, changelogs, and Markdown where an en dash is inconvenient to type. What is never acceptable: "3.2 - 4.0" with spaces around a hyphen (looks like a subtraction), or "from 3.2-4.0" (mixing "from" and a range dash without "to"). The most important rule is consistency within a document.
5 / 5
A README says: "This library supports Node.js versions 18, 20, and 22. We recommend using the latest 22 LTS release." What is the number style issue?
Option C is correct. The sentence "using the latest 22 LTS release" is ambiguous — "22" reads as either a version identifier or a quantity (twenty-two LTS releases). Rewrite as "the latest Node.js 22 LTS release" to make clear that "22" is a version designator, not a count. This is the key distinction between version numbers (product-specific identifiers: Node 22, Python 3.11, v2.0.1) and quantitative numbers (counts and measurements). Version numbers are always digits and always prefixed with the product name on first reference. Option A is wrong — never spell out version numbers. Option D is wrong — major version numbers don't take .0 unless that is the actual release version.