Explore tens of thousands of sets crafted by our community.
Grammar and Punctuation for Technical Writers
29
Flashcards
0/29
Modifying Clause Placement
Modifier clauses need to be placed near the noun they modify to avoid confusion. Example: Incorrect - 'Running quickly improves your health when done regularly.' Correct - 'When done regularly, running quickly improves your health.'
Use of the Subjunctive Mood
The subjunctive mood is used when discussing hypothetical situations, making requests or suggestions, or stating wishes. Example: 'If I were the project manager, I would initiate a review process.'
Concise Writing
Eliminate unnecessary words to make sentences clear and concise. Example: Incorrect - 'It is important to note that...' Correct - 'Note that...'
Active vs Passive Voice
Active voice occurs when the subject of the sentence performs the action. Passive voice occurs when the subject is acted upon. Example (active): 'The engineer designed the circuit.' Example (passive): 'The circuit was designed by the engineer.'
Capitalization of Titles and Headings
In titles and headings, capitalize the first and last words, all nouns, pronouns, adjectives, verbs, adverbs, and subordinate conjunctions. Example: 'The Quick Brown Fox Jumps Over the Lazy Dog.'
Correct Use of 'Fewer' and 'Less'
Use 'fewer' for countable objects and 'less' for uncountable quantities. Example: 'Fewer ingredients make the recipe simple.' 'There is less sugar in this recipe.'
Hyphens in Compound Adjectives
Hyphens are used in compound adjectives before a noun to clarify meaning. Example: 'A user-friendly interface is preferred.' Without the hyphen, the meaning can be unclear.
Dash Usage
Use dashes to create emphasis, indicate an interruption, or separate additional information in a sentence. Example: 'The latest prototype—an improvement over the previous one—will be tested tomorrow.'
Proper Use of Quotation Marks
Quotation marks are primarily used to denote the beginning and end of direct speech or quotations. Example: 'The participant said, "The interface is intuitive."'
Split Infinitives
Split infinitives occur when additional words are inserted between 'to' and the verb. While not always incorrect, it is often better to avoid splitting infinitives for clarity. Example: 'To clearly understand the text, you must read carefully.'
Ensuring Parallel Structure
Parallel structure involves using the same pattern of words to show equal importance among ideas. Example: 'The experiment requires preparing samples, conducting trials, and analyzing results.'
Subject-Verb Agreement
The subject and verb in a sentence must agree in number. Example: 'The team is working on the project.' (singular) 'The teams are working on their projects.' (plural)
Interjections
Use interjections sparingly in technical writing. They can express emotion or capture attention but can also disrupt the formal tone. Example: 'Wow! These results are better than expected.' (Use cautiously)
Proper Use of Italics
Use italics for emphasis, foreign words, titles of books and journals, or when introducing a term. Example: 'The term eutrophication signifies the ecological response to the addition of artificial or natural substances.'
Use of Apostrophes
Apostrophes indicate possession or contractions. Example (possession): 'The manager's report.' Example (contraction): 'It's (it is) important to document your sources.'
Comma Splices
Comma splices occur when two independent clauses are joined with just a comma. To correct a comma splice, use a semicolon, a period, or a conjunction with a comma. Example: Incorrect - 'It's raining, we should cancel the event.' Correct - 'It's raining; we should cancel the event.'
Pronoun Reference Clarity
Ensure that all pronouns clearly refer to the nouns they replace to avoid ambiguity. Example: Incorrect - 'When Jim gave Bob his book, he was happy.' Correct - 'Jim was happy when he gave Bob the book.'
Consistent Tense Usage
Maintain consistent tense within a paragraph or section of your technical document unless the timeline necessitates a change. Example: 'We tested the software and then published the results.'
Colon Usage
Colons are used to introduce lists, quotes, explanations, or definitions, but only after a complete sentence. Example: 'She offered a compelling argument: more data security measures are needed.'
Parenthetical Elements
Parenthetical elements are non-essential parts of a sentence enclosed by commas, parentheses, or dashes. Example: 'The results of the study (which took three years to complete) were groundbreaking.'
Use of Contractions
Avoid contractions in formal technical writing to maintain a professional tone. Example: 'Do not use contractions.' instead of 'Don't use contractions.'
Correct Use of 'Which' and 'That'
'Which' introduces nonrestrictive clauses, while 'that' introduces restrictive clauses. Example (Nonrestrictive): 'The report, which was released yesterday, contains the findings.' Example (Restrictive): 'The report that was released yesterday contains the findings.'
Accurate Modifier Use
Modifiers must clearly and accurately describe the word or words they are meant to modify to avoid ambiguity. Example: Incorrect - 'She almost drove her kids to school every day.' Correct - 'Almost every day, she drove her kids to school.'
The Oxford Comma
An Oxford comma is used before 'and' or 'or' in a list of three or more items to prevent ambiguity. Example: 'We need to order bolts, nuts, and washers.'
Ellipsis Usage
Use ellipses to indicate omitted words from a quoted passage or to show a trailing off in thought. Example in quotations: 'The conclusion...suggests further research.'
Correct Use of Semicolons
Semicolons are used to join two independent clauses without a conjunction, or to separate items in a list where the items themselves contain commas. Example: 'She programmed the device; it functioned perfectly.'
Comma Usage with Nonrestrictive Elements
Nonrestrictive elements, which aren't essential to a sentence's meaning, are enclosed in commas. Example: 'Our server room, which is extremely secure, holds all the backup data.'
Numbers in Text
Spell out numbers zero through nine and use numerals for 10 and above in technical writing. Example: 'Four components were tested and 12 were found to be faulty.'
Correct Use of Articles
Use 'a/an' for non-specific items and 'the' for specific items. Example: 'Please hand me a pen. Give me the pen on your desk.'
© Hypatia.Tech. 2024 All rights reserved.