Technical Report Style Guide For Authors

Size: px
Start display at page:

Download "Technical Report Style Guide For Authors"

Transcription

1 Parenteral Drug Association Technical Report Style Guide For Authors December 2016 PDA.org Page 0 of 18

2 TABLE OF CONTENTS Preface... 3 Style Guides and Resources... 3 Introduction... 3 Writing the Technical Report... 3 TECHNICAL REPORT TEMPLATE... 3 LENGTH OF TECHNICAL REPORT... 3 Structure of Technical Report... 4 Cover Page... 4 Table of Contents Introduction Purpose Scope Glossary Body of the Report References... 6 WHAT TO REFERENCE... 7 HOW TO REFERENCE QUOTATION MARKS... 7 Writing Style... 8 COMMUNICATION BASICS... 8 SENTENCE STRUCTURE... 8 PARAGRAPHS... 8 VOICE, TONE, AND STYLE... 8 POINT OF VIEW... 9 ACTIVE VS. PASSIVE VOICE... 9 CONCISE LANGUAGE... 9 HYPHENATION... 9 LISTS NUMBERS VS. BULLETS CAPITALIZATION EUROPEAN VS. WESTERN SPELLING ACRONYMS FIGURES AND TABLES PRODUCTION PROOFS References Appendix 1: PDA Technical Report Reference Guide Appendix 2: Quick Reference Grammar and Punctuation Guide PDA.org Page 1 of 28

3 PDA.org Page 2 of 28

4 Preface This document is designed to provide direction and advice to PDA Technical Report Teams (TRT) who are sharing their knowledge with their peers through the technical report development process. The goal is to produce a concise, science-based, readable report that will advance industry practices. This style guide can be used in conjunction with the Technical Report Template as a convenient reference to facilitate the writing process. The TRT Leader(s), working with the PDA scientific and regulatory affairs (S&RA) staff, should strive to follow the guidance in this document in order to ensure that high-quality documents, with a consistent voice and the PDA brand, are published. The resources used to prepare this manual were selected for applicability and accessibility for PDA members: Chicago Manual of Style, The ACS Style Guide, ISO 690 Guidelines for Bibliographic References and Citations, and Purdue Online Writing Lab. Where guidance is not based on these resources, the source is provided. Style Guides and Resources The resources discussed below were used as the primary resources for writing this style guide and may provide further guidance on editorial style for the content of PDA technical reports. Abbreviations, Formulas, and Terms. The American Chemical Society (ACS) Style Guide provides advice on using abbreviations and acronyms; formatting equations and math; representing physical and chemical terms, compounds, and notations; and using related parentheses and brackets in a sentence. When the ACS Guide differs from specific standards used by the pharmaceutical and biopharmaceutical industry, the industry standard applies. For all other content and formatting, including computer terms, the Chicago Manual of Style (16th Ed., 2010) or the Chicago Manual of Style Online ( is preferred. References and Citations. PDA uses the ISO 690 Numerical Reference system for formatting source information. The PDA Technical Report Reference Guide provides general information on formatting references and how to use the References/Citation function in Microsoft (MS) Word to enter and manage source information. Spelling. Generally, PDA follows the Merriman-Webster online dictionary ( for spelling; however, when a word is used as an industry standard, the industry standard applies. PDA.org Page 3 of 28

5 PDA Technical Report Style Guide Introduction This style guide, used in conjunction with the Technical Report Template, provides a resource to those writing technical reports published by the Parenteral Drug Association (PDA). PDA members highly value these technical reports because they offer expert guidance and opinions on important scientific and regulatory topics. They are peer-reviewed, global-consensus documents written by subject matter experts on issues relating to a wide array of challenging technical areas. PDA technical reports are used as essential references by industry and regulatory authorities around the world. The TRT is expected to complete a working draft of their technical report within the 18-month cycle indicated in Figure 1. The PDA Technical Report Team Handbook and TR Team Training presentation provided on the online collaborative workspace describe the process in more detail. Figure 1. Technical Report Cycle Writing the Technical Report TECHNICAL REPORT TEMPLATE TRT members draft the PDA technical report using a customized template developed in MS Word that is supplied by the S&RA staff on the TRT s PDA Workspace. The Technical Report Template outlines all the necessary components needed to develop the report in a preset format. LENGTH OF TECHNICAL REPORT Technical reports should be no longer than 60 pages, maintaining the preset template fonts and margins. Should a report surpass the recommended length, there are a few methods that can be employed to reduce content: Eliminate unnecessary or extensive quoting, particularly from government guidances or other PDA technical reports, by citing the document instead Replace dense text with a clear figure or table Omit any figures and tables that do not enhance the text Omit multiple occurrences of repeated figures or blocks of text, such as steps or processes, by adding a reference to the first occurrence Move repeated figures or blocks of text to an appendix and reference it in the body of the report. PDA.org Page 3 of 18 PDA.org Page 4 of 28

6 If it becomes evident that 60 pages in not adequate to cover the topics of the project, TRTs are strongly encouraged to create a series of reports. The S&RA can assist teams in developing distinct topical reports in a logical progression. Structure of Technical Report The TRT will be supplied with a template that includes all the sections required to develop a technical report, as listed in Figure 2. Additional Reading and Appendix sections are optional. Cover Page Table of Contents 1.0 Introduction 1.1 Purpose 1.2 Scope 2.0 Glossary 2.1 Abbreviations (optional) 3.0 Body of Work (Section 3.0, 4.0, etc.) 4.0 References 5.0 Additional Reading (optional) 6.0 Appendices (optional) Figure 2. Typical Structure of a PDA Technical Report Cover Page The TR Team supplies a title for the technical report and the names of the authors. The TRT Leader maintains an up-to-date list that includes the correct spelling of each person s name, title, current affiliation, academic degrees, and contact information. Only advanced degrees are included (e.g., JD, MD, PhD, DVM, PharmD, etc.). Table of Contents The TRT builds the Table of Contents and Scope statement at the start of the technical report development process. The Table of Contents lists the top three level headings of the report body and their page numbers for quick identification of specific topics. Each chapter is numbered sequentially according to the Technical Report Template numbering system. By using the MS Word styles imbedded in the template, the Table of Contents can be generated and updated automatically. 1.0 Introduction The total length of the Introduction section, including the Purpose and Scope subsections, should be no longer than one-and-a-half pages. PDA.org Page 5 of 28

7 The Introduction presents the technical report topic to the reader and places it in context. Example: Pharmaceutical companies and suppliers often make quality decisions based on visual inspections of packaging components without the aid of universal guidelines or standards. However, the industry lacks an approach to a quality decision-making process for identifying and classifying visual nonconformities for elastomer components and aluminum seals. The first paragraph should explain the issue and its significance, and briefly summarize any historical or background information. Discussion can describe any gaps in existing information, research, etc., and support it with source information from published PDA technical reports or other works. Example: Historical surveys of cell lines have found high rates of mycoplasma contamination in research labs and production facilities (1; 2). There should be no lists, definitions, or details in this section. 1.1 Purpose The Purpose subsection outlines the challenge being addressed and describes how the report will address that challenge. Example: This document serves to complement the information provided in PDA Technical Reports TR39, TR58, and TR64 by describing in more detail the qualification and operational use of passive thermal protection systems (1; 2; 3). There should be no lists, definitions, or details in this subsection. 1.2 Scope The Scope subsection clearly defines the content of the report and can describe any exceptions, limitations, exclusions, or specific inclusions. It may include statements of intended use or broadly identify how the material in the report is organized. When useful of necessary, the TRT can also include an out of scope statement that describes explicitly what is not covered related to the topic. Example 1: No attempt is made to encompass all types of unit operations for which reprocessing could be considered. Example 2: Diagnostics and components, such as blood collection stoppers and needle sleeves used to collect blood, and medical device components such as gaskets, diaphragms, and O-rings, are out of the scope of this report. There should be no lists, definitions, or details in this subsection. PDA.org Page 6 of 28

8 2.0 Glossary The Glossary includes a list of common terms specific to the technical report topic. Definitions of terms are listed alphabetically and should come from official sources such as the U.S. Pharmacopeia (USP), American Society for Testing Materials (ASTM), International Conference on Harmonisation (ICH), International Organization for Standardization (ISO), or other PDA technical reports. For consistency, using definitions from existing PDA technical reports is preferred; the S&RA staff is developing a master glossary of terms used in current technical reports that will be made available to members. Definitions quoted from other sources should be cited at the end of the definition and the source information should be included in the References section. A subsection can be added, if needed, to list acronyms that are used throughout a report. Examples are provided in the template. 3.0 Body of the Report The TRT develops the body of the report according to the defined Scope, expounding on statements made in the Introduction and providing supporting details. Information can be presented in text, tables, and bulleted or numbered lists; figures and graphs that enhance the content of the report can be included as well. Using a consistent style to present the material (e.g., lists, bullets, etc.) contributes to the flow and readability of the report. The Technical Report Template formats text in the style where it is entered. To add a section beyond those presented in the template and format it in the same manner: 1. Type the new section heading into the text and leave the cursor there 2. Move your pointer to the Styles group on the Home Tab 3. Click on the drop down list to reveal heading and text styles 4. Click on the heading level or type of text for the chosen content 5. The text should change to the style chosen (Figure 3). Figure 3. Use the Styles group in MS Word to format sections added to Technical Report Template Headings and text may change as the document develops. The S&RA staff will review the final draft technical report to make sure the content is sequenced correctly. If an Appendix section is added to the technical report, it should supply related, supplementary information and should be identified in the body of the text. Appendices are considered standalone documents, so each appendix should include its own References section, if needed. 4.0 References The References section is numbered sequentially following the last section of the content. This single section includes citations from the body of the document; the references are not listed by section nor are references from any appendices included. PDA.org Page 7 of 28

9 Source documents can be added to the technical report at any time using the automated MS Word citation tool. PDA uses the ISO 690 Numerical style format. A copy of the PDA Technical Report Reference Guide, containing illustrated instructions on how to insert citations using the MS Word citation tool, is attached as Appendix 1. Note: Wikipedia is not considered a reliable reference source and should not be used for PDA technical reports. If the technical report includes an Additional Reading section, it should be formatted in the same manner as the References section, but should not duplicate any of the References material. The TRT Leader(s) must ensure that all references and sources presented in the technical report are accurate, complete, and current prior to finalizing the draft report for acceptance reviews. WHAT TO REFERENCE To recognize the work of others incorporated into the report paraphrased content, direct quotations, graphics, etc. the text should be identified with a reference. This applies to any material that is not original work or is outside the fair use guidelines (1), including public use documents, such as Food and Drug Administration guidances or ICH quality guidelines. Commonly known or readily verifiable facts, proverbs, and other familiar expressions can be stated without quotation or attribution, unless the wording is taken directly from another source. The citation should be inserted close to the referenced text. If the reference applies to a specific word, words, phrase, or quote within a sentence, the citation is inserted immediately after the quote. If the reference refers to an entire sentence, paragraph, or passage, the citation should be inserted immediately before the period at the end of the last sentence, e.g., (#). HOW TO REFERENCE QUOTATION MARKS Quotation marks should be used to denote content or terms used verbatim, using only as much of a quotation as is needed to convey the message. For quotes fewer than three lines: Use double quotation marks (" ") around a sentence or group of words quoted in the text and always provide the source for the quoted material in a citation, e.g., (#). Use single quotation marks (' ') when enclosing a quote within a quote. Use double quotation marks around a single special word or term the first time it is used, but not for subsequent occurrences; if the special word or term is hyphenated, no quotation marks are used. Periods and commas stay inside the quotation marks; colons, semi-colons, exclamation points, and question marks go outside the quotation marks, unless they are part of the quoted material. Note: The British style of quotation reverses the double/single quotation marks rule, as does the style of many other countries. PDA follows American rules of punctuation. Quotations of three or more lines should be placed in a separate, indented paragraph using italic type; no quotation marks are needed. The source should be placed at the end of the last sentence. When paraphrasing another s work, no quotes are used; however, the source should be cited at the end of the material paraphrased, e.g., (#). Italics can be used to denote emphasis, rather than enclosing common words in quotation marks. PDA.org Page 8 of 28

10 Writing Style COMMUNICATION BASICS For effective communication, a message needs to be clear, concise, consistent, and usercentered. The purpose of technical writing is generally to communicate complex ideas, concepts, processes, or procedures. In order to do so, writers first need have a clear idea who their audience is and the purpose the document will serve. Fundamentally, the members of the TRT need to make sure the PDA technical report is clear and easy for the intended audience to understand so the information it contains can be put into practice. In other words, writers should provide the information their readers need in a manner they understand, in as few words as possible, and in the same voice and verb tense. SENTENCE STRUCTURE Good technical writing uses short, concise statements and avoids synonyms. Following these general guidelines should keep the message from getting lost in rhetoric. If a sentence is the length of a paragraph, consider breaking it into two sentences. When using compound sentences, make sure the structure and meaning of each clause is understandable and the relationship between the clauses is logical. Vary sentence length, especially for long spans of continuous text. When describing steps or actions to perform, try to keep sentence length to approximately 15 words. Put familiar information at the beginning of a sentence and introduce new, complex information at the end of the sentence. When using a pronoun, make sure it is clear what noun it is replacing. Keep modifiers words, phrases, clauses near the subject or verb they modify to avoid ambiguity. Avoid using long strings (more than three consecutively) of nouns or modifiers. (2; 3; 4) PARAGRAPHS Paragraphs should consist of developed thoughts with each sentence connected to the topic sentence linked to the next paragraph by a logical transition so readers understand how the paragraphs relate. The main point can be stated at the beginning or at the end of the paragraph. Shorter paragraphs are more concise, easier to read, and easier to comprehend. VOICE, TONE, AND STYLE Voice refers to a person s unique word choices and chosen point of view. PDA technical publications are scientific documents written in formal language using the third-person point of view. Authors should strive to maintain third-person point of view throughout these documents. Tone refers to the attitude conveyed by the author in the written piece. PDA technical reports are science- and fact-based documents; therefore, sentences should not convey personal or corporate opinion, conjecture, or editorial content. PDA.org Page 9 of 28

11 Style refers to the way a piece is written, rather than the meaning of the content. Even though most technical reports are written by a team of individual members, all parts of the technical report should blend to reflect a coherent and consistent style (5). POINT OF VIEW Third person tells a story from an outside narrator s point of view. It is the traditional format of academic and report writing as the purpose is to deliver information to the reader. Third person uses pronouns such as he, she, and it. To create a cohesive document, authors should strive to maintain third-person point of view throughout the report so as not to confuse the reader. ACTIVE VS. PASSIVE VOICE In active voice, the subject of the sentence is followed closely by the verb, with the subject performing the action of the verb. Sentences written in active voice tend to be more concise, are more easily understood, and make a stronger statement. Active voice should be used as much as possible in technical reports. In passive voice, the subject receives the action of the verb. In general, using passive voice should be avoided; it often leads to wordier sentences, which can be difficult to follow. Even though acceptable uses of passive voice exist, its use in technical reports should be limited. Sentences should be transposed from passive to active voice wherever possible. CONCISE LANGUAGE The goal in concise writing is to use the most effective words to communicate the message. Using only words in a sentence that are necessary to convey meaning and avoiding nonessential words, particularly adjectives and adverbs, will result in more succinct language. Nominalization, that is, transforming a verb or adjective into a noun by adding ion/tion, ment, ity/ty, ation, or ness, often dilutes the meaning or impact of a word, and should be avoided. For example, using decide rather than make a decision, or intervene instead of hold an intervention strengthens the sentence by adding action. For quick reference, Appendix 2 provides additional information on troublesome sentence structure, punctuation, and word use that is commonly encountered in report writing. HYPHENATION Hyphens can be used to combine two or more words that will be used as a single adjective before a noun (e.g., animal-derived components), to form compound numbers (e.g., forty-three), or to add a prefix to a word (e.g., mid-october). They can also provide clarity when the potential exists for a reader to misunderstand the writer s intent, e.g., re-sign vs. resign. The Merriman-Webster online dictionary provides extensive lists of hyphenated words beginning with prefixes such as non-, pre-, ex-, etc. Some examples of commonly used industry terms are: PDA.org Page 10 of 28

12 Hyphenated Post-approval (adjective) Science-based, risk-based In-process Cross-contamination, cross-flow Re-test Pre-sterilization, non-sterile Cool-down (adjective) Not Hyphenated Prefilled Biowaiver, bioburden Lifecycle Nonconformity Shelf life Standalone (adjective) Log-in/log-off (noun) LISTS NUMBERS VS. BULLETS When writing a report, a list may be the appropriate format to make key information stand out from the text, such as step-by-step instructions. Lists should not stand alone in a report, however; they should be introduced by an explanation or brief description. Numbered lists are generally used when the information is serialized or the text is hierarchical; otherwise, a bulleted list can be used. The use of bullets and lists in technical reports should be minimized. CAPITALIZATION Words should be capitalized when they are proper nouns, that is, when they describe a specific entity; otherwise, lower-case letters are used for common nouns, even if the term has a wellknown acronym, e.g., good manufacturing practices (GMP). EUROPEAN VS. WESTERN SPELLING When there is a regional difference in the spelling of a word, with a few exceptions, PDA uses the Western spelling. If the word is part of a proper name or title, or it is within a quote, the spelling should not be changed (e.g., International Conference on Harmonisation). ACRONYMS The first use of any word that will be referred to by an acronym throughout the report should be spelled out, followed by the acronym in parentheses. Generally, the terms in the text should appear in lower case, such as current good manufacturing practices (cgmp), unless otherwise commonly used by the industry, e.g., Drug Master File (DMF). FIGURES AND TABLES Any images obtained from an outside source, rather than created for a PDA technical report, are considered intellectual property and require written permission for publishing. That includes concepts in diagrams of processes and workflows not created or owned by PDA. If certain photographs, images, etc., are needed to illustrate an idea or a component, such as a photograph of a specific piece of equipment, the TRT Leader(s) must provide the source of the image and documented permission to the S&RA staff. PDA has a licensing agreement for use in securing permissions; it can be found in the Shared Documents folder on the PDA Workspace. The S&RA staff will follow up with the TRT Leader(s) to secure licenses for all graphics, photographs, tables, etc., not created exclusively for the technical report. All drawings and photographs must be submitted to PDA in their original format (JPEG, TIFF, PNG, EPS, etc.); for visual clarity, they must have a resolution of at least 300 dpi. Graphics or images created with a drawing program should be saved as a JPEG or TIFF file, if possible. PDA.org Page 11 of 28

13 Tables created in MS Excel can be transmitted as XLS or XLSX files; graphics created in MS PowerPoint can be sent as PPT or PPTX files. PDA sometimes redesigns figures and tables to meet production requirements and its publishing standards. Clipart and similar graphics generally are not compatible with the tone of PDA technical publications; therefore, PDA reserves the right to exclude artwork not in keeping with its policy for technical reports. PRODUCTION PROOFS Once typesetting is completed, the document is distributed to the TRT Leader(s) and the S&RA staff for final review. All comments, corrections, and recommendations should be submitted to the S&RA staff within five (5) business days of receipt, whenever possible. The S&RA staff will coordinate with the TRT Leader(s) to review modifications. If necessary, a final proof will be distributed to the group so that changes to the first proof can be verified. Note: The proofing cycle is not an opportunity for the TRT to rewrite, add, or delete information from the technical report. That work must be completed prior to the publication stage. References 1. U.S. Copyright Office. 17 USC 107. Limitations on exclusive rights: Fair use. Copyright.gov. [Online] [Cited: Oct 27, 2016.] 2. Philip Rubens, Editor. Science and technical writing: a manual of style, 2nd ed. New York : Routledge, ISBN IEEE Professional Communication Society. Communication Resources for Engineers. IEEE, Advancing Technology for Humanity. [Online] [Cited: Nov 7, 2016.] 4. The Plain Language Action and Information Network (PLAIN). Quick tips to help you write more clearly. Federal Plain Language Guidelines. [Online] March [Cited: Nov 7, 2016.] 5. Wheaton College Writing Center. Style, Diction, Tone, and Voice ( Tone-and-Voice; accessed Oct 2016). PDA.org Page 12 of 28

14 Appendix 1: PDA Technical Report Reference Guide It is important for Task Force members to thoroughly read this document prior to entering references. PDA Task Forces are responsible for ensuring that all references are accurate and complete. Whenever a source is referred to, quoted, borrowed (under fair use) including figures, tables, images, and other artwork, etc., references are needed. This applies even to public sources, such as U.S. FDA guidances, U.S. regulations/laws, and ICH quality guidelines. In every case, if a reference can be accessed online, include the website address. For journal articles, include the Document Online Identifier (DOI) number if available. Task Forces must double check the website addresses and indicate the date the website address was last accessed (more on this below). PDA follows ISO 690 conventions to format the references. The figures below show how to set up each reference within Microsoft Word. 1. Click the References tab and, in the Citations & Bibliography section, click the arrow next to Style. Choose ISO 690 Numerical Reference from the drop down list. PDA.org Page 13 of 28

15 2. Click the 'Insert Citation button and select Add New Source. 3. In the pop-up window, click the arrow next to Type of source and select from the drop down menu, i.e., book, journal article, conference proceedings, website etc. PDA.org Page 14 of 28

16 4. In the pop-up window, select Corporate Author, if appropriate, for organizations such as a regulatory agency or standard-setting organization. 5. Enter the source information into the corresponding fields. If there is a web link to the source, place this and the date the webpage was accessed in the Standard Number field in order o display the information in the reference. PDA.org Page 15 of 28

17 6. If the source is a journal article, book, etc., with multiple authors, click the Edit button next to the Author field. In the, single or multiple author names can be entered. Click OK when complete. 7. There is a Tag field in the bottom left corner of the pop-up window. ISO 690 automatically identifies the source by the first three letters of the author s name and last two digits of the year of publication. ISO 690 requires citations to be unique; if your source is not unique, the citation manager flashes up a message that it will need to be changed. To change the Tag, either change the tag initials or add an alphabetical character after the year. Example: The Tag for a 2010 International Conference on Harmonisation guidance appears as Int10 ; however, your document already contains an entry for the 2010 International Pharmacopeia tagged as Int10. You could change the New Source Tag to ICH10 or to Int10a or something else appropriate. PDA.org Page 16 of 28

18 8. Move to the end of the document where the references will be listed and place the cursor below the 7.0 References heading. Click the Bibliography button and select Insert Bibliography from the drop down menu (prevents the manually typed title of References from being overwritten). 9. The referenced sources will appear at this point, formatted according to ISO 690 specifications. PDA.org Page 17 of 28

19 10. To add more references, follow steps 2-. Technical Report Style Guide For Authors 11. To update the list, right click on any citation entry in the text or in the Reference section, and select Update Field. PDA.org Page 18 of 28

20 12. Citation numbers in the text will adjust automatically and add will appear in the References section. 13. To reference a particular source again in the document, place your cursor at the desired location in the text and click the Insert Citation button. Select the appropriate source from the list. PDA.org Page 19 of 28

21 14. To insert multiple citations for a single instance, position the cursor inside the parentheses of the initial reference number. 15. Click the Insert Citation button and select the source from the list, or add a new reference source. 16. The additional reference number will be added to the text. PDA.org Page 20 of 28

22 17. To remove one of multiple citations, click on the reference numbers, and then click the down arrow in the gray next to the reference numbers. Move your cursor to Remove Citation and select the citation to be removed. 18. A placeholder can be inserted for material that will need a citation source, but the details are not at hand. Click the Insert Citation button, and select Add New Placeholder from the drop down menu. PDA.org Page 21 of 28

23 19. The placeholder can be given a name as a reminder of what material needs to be added. Please note: Placeholder names cannot include spaces. 20. The image below shows two reference placeholders. The details can be added later by clicking on the reference number, selecting Edit Source, and selecting the placeholder to be edited. A pop-up window, like that in step 4, will appear. Enter the information in the corresponding fields, as for any other source. PDA.org Page 22 of 28

24 12. Citation numbers in the text will adjust automatically and add will appear in the References section. 13. To reference a particular source again in the document, place your cursor at the desired location in the text and click the Insert Citation button. Select the appropriate source from the list. PDA.org Page 23 of 28

25 Appendix 2: Quick Reference Grammar and Punctuation Guide SUBJECT-VERB AGREEMENT A verb must agree with its subject in number and person. You requires a plural verb, even if it refers to a single person. Adding s or es to a noun makes it plural; adding s or es to a verb changes it to third person singular. Compound subjects joined by and require a plural verb, unless the connection refers to the same entity, e.g., president and CEO or franks and beans. Two or more subjects joined by and, if preceded by each, every, or many a/an, requires a singular verb. If the subject consists of two or more singular words connected by or, either/or, neither/nor, or not only/but also, the subject is singular and requires a singular verb. If the subject consists of two or more plural words connected by or, either/or, neither/nor, or not only/but also, the subject is plural and requires a plural verb. If the subject consists of two or more plural and singular words, the verb should agree with the word closest to the verb. (Tip: Since plural subjects sound better with plural verbs, organize the sentence so the last subject is plural and use a plural verb.) When trying to determine the agreement between subject and verb, ignore any intervening phrases (usually separated by commas); look only at the subject and verb. When the phrase one of appears in a sentence, e.g., one of those, the subject is singular and requires a singular verb. When a phrase or clause is the subject, the verb is singular, except when the phrase begins with what; then, whether the verb is singular or plural depends on the meaning, e.g., What we need is a new policy vs. What we need are guidelines to follow. PARALLEL STRUCTURE Parallel ideas should be presented in parallel structure, i.e., adjectives should parallel adjectives, nouns should parallel nouns, verbs should parallel verbs, clauses should parallel clauses, etc. Parallelism is especially important in lists, bulleted or numbered. Each line should begin using the same part of speech (e.g., verb, gerund, noun, etc.) and the ending punctuation, if used, should be the same (comma, semicolon, or period). 1 SPLIT INFINITIVES Infinitives consist of the word to and a verb that functions like a noun, adjective, or adverb, for example, to sterilize, or to define. A split infinitive occurs when a word is inserted between to and the verb, such as to effectively sterilize, or to clearly define. Though sometimes it is impossible to avoid splitting an infinitive without changing the intended effect, it is better to avoid using split infinitives in formal writing. 1 Sabin, William. The Gregg Reference Manual: a manual of style, grammar, usage, and formatting, 10th ed. New York: McGraw-Hill/Irwin, PDA.org Page 24 of 28

26 MISPLACED MODIFIERS Modifiers are words or phrases that describe, clarify, or give detail to some part of a sentence. Misplaced modifiers describe an unintended part of the sentence, or an implied word that is not included in the sentence. This frequently happens with introductory phrases and can create a confusing statement or illogical relationship with the subject of the sentence. As a rule, modifiers are best kept as close as possible to the part of speech they are modifying, e.g., a one-word adjective right before the noun it modifies or a modifying phrase immediately preceding or following the item it modifies. Participial phrases most commonly a phrase beginning with a verb + ing generally modify the subject of the sentence. Unless the correct subject is placed immediately after the participial phrase, however, the phrase dangles, modifying the wrong noun. The best strategy to correct a dangling participle or misplaced modifier is to identify in the main clause of the sentence who or what is doing the action, and then revise the sentence to match the modifier with the subject. Another method is to change the introductory phrase to a complete clause that identifies the subject performing the action of the verb. PUNCTUATION Punctuation provides the emphasis in writing that pauses and changes in tone of voice provide in speaking. Knowing what and how to use it lends clarity to written statements. Below is a brief overview of commonly used and misused punctuation and words. Commas, Semicolons, and Colons Writers use commas in numerous ways to separate clauses, elements in a series, nonessential parts of a sentence, and transitional words or phrases, among others to help the reader navigate a sentence or passage. In reports, commas are used most often to: Join two independent clauses (clauses that could stand alone as sentences) and a conjunction Follow an introductory phrase or dependent clause Separate elements in a series (PDA follows the Chicago Manual of Style on serial commas, that is, a comma is placed after every element in a series of three or more, including before a conjunction.) Set off nonessential elements in a sentence Separate coordinate adjectives (adjectives that are equal and reversible) Follow a transitional word or phrase Precede quoted words. Semicolons are used most often to: Separate two independent clauses that closely relate to each other; the clauses would not generally connect using only a coordinating conjunction (e.g., and, but, or so) Join complex clauses with a coordinating conjunction Separate items in a complex list, for instance, when a series of elements already contains commas or extensive phrases Separate two clauses with a conjunctive adverb or transitional phrase. PDA.org Page 25 of 28

27 Colons are used most often to join two independent clauses, when the emphasis should be on the second clause, or when the first clause will be followed by a list or quotation. Commonly Misused Punctuation and Challenging Words Academic degrees Changing case in quotations Company-related abbreviations Serial commas Note parallelism: each item in the series begins with a verb Ellipsis (i.e., ) e.g. i.e. US/U.S./United States Do not use periods to separate letters for doctoral degrees, e.g., JD, PhD, PharmD, MD, DVM. The first letter of the word inside a quoted sentence or phrase may be changed to lower case if quoting inside a sentence, or to upper case if beginning a sentence. Inc. or Ltd., or Inc. Ltd.; but not Inc., Ltd. Place a comma before the conjunction (usually and or or ) in a series of words or phrases, e.g., A design review evaluates deliverables against standards and requirements, identifies problems, and proposes required corrective actions. Three in a series indicates text has been omitted. Four in a series indicates text has been omitted and it is the end of a sentence (usually within a quote). Make sure that the words removed do not alter the basic meaning of the original quote in any way. Means for example Include a comma before and after e.g. when used in a sentence, or after e.g. when beginning a list. Example: required to prepare the medication, e.g., vial-tosyringe transfer, dilution, or use of a filter. Means that is and is equivalent to in other words Include a comma before and after i.e. when used in a sentence, or after when separated from the sentence. Example: (i.e., are testable). In general, spell out US (United States) when used as a noun and keep the acronym US when used as an adjective. Examples: a. (Noun) The book describes the marketing strategy for Japan, European Union, and the United States. b. (Noun, adjective) In the United States, the Drug Amendments Act (1962) required FDA approval for all new US drug applications. c. (Adjective and not part of the official title) The single regulation in the US Code of Federal Regulations. d. (adjective, part of official title) U.S. Government Publishing Office PDA.org Page 26 of 28

28 A vs. an Apostrophes Assure/ensure/insure If the word begins with a vowel sound, use an before the word; if the word begins with a consonant sound, use a before the word, no matter how the word is spelled. 1 Examples: an historic act; an Ouachita city; an hour ago; an LSAT exam; an x-ray Apostrophes create contractions or indicate possession Assure is something you do to a person, a group of people, or an animal to remove doubt or anxiety Ensure is something you do to guarantee an event or condition [will happen] Insure is when something can be done to a person, place, or thing, but it's reserved for limiting financial liability, most commonly by obtaining an insurance policy 2 Coordinating conjunctions If/then Its vs. it s If vs. whether Regardless vs. irregardless Toward vs. towards Use the mnemonic FANBOYS to remember the coordinating conjunctions: for, and, nor, but, or, yet, so. If/then generally reflects a cause/effect relationship. If something happens then something else will happens. In this case, include then in the statement. But omit then in cases such as the following example: Recalibrate if the equipment is continually out of tolerance. It s is a contraction of it is ; its is the possessive form of the pronoun it. Possessives for pronouns do not use an apostrophe. These can sometimes be used interchangeably, though at times the wrong word will change the meaning. The general rule is: Use if when the statement is conditional, e.g., If it rains, the game won t be played. Use whether to show that two alternatives are possible, e.g., I don t know whether the game will be played today or Monday. Irregardless is a nonstandard word (in common use but not a proper word) that some people use to mean regardless. Regardless means without regard ; adding the negative prefix ir creates a double negative (without without regard). In the United States, toward (a person or thing moves toward something) is used with no s ( towards is sometimes used in a less formal context but not in PDA technical reports). Example: This last scenario (plunger movement during injection) occurs because the plunger stopper not only glides upon a silicone layer, but also pushes silicone oil toward the needle upon injection. 1 University of Chicago Press, The Chicago Manual of Style Online, Russell David Harper, ed. Chicago: University of Chicago Press, (accessed October 2016) 2 Carson, Charles. Assure versus Ensure versus Insure. Edited by Mignon Fogarty. Quick and Dirty Tips Website, August 26, (accessed Oct 27, 2016) PDA.org Page 27 of 28

CSc Senior Project Writing Software Documentation Some Guidelines

CSc Senior Project Writing Software Documentation Some Guidelines CSc 190 - Senior Project Writing Software Documentation Some Guidelines http://gaia.ecs.csus.edu/~buckley/csc190/writingguide.pdf Technical Documentation Known Problems Surveys say: Lack of audience definition

More information

Alphabetical Index referenced by section numbers for PUNCTUATION FOR FICTION WRITERS by Rick Taubold, PhD and Scott Gamboe

Alphabetical Index referenced by section numbers for PUNCTUATION FOR FICTION WRITERS by Rick Taubold, PhD and Scott Gamboe Alphabetical Index referenced by section numbers for PUNCTUATION FOR FICTION WRITERS by Rick Taubold, PhD and Scott Gamboe?! 4.7 Abbreviations 4.1.2, 4.1.3 Abbreviations, plurals of 7.8.1 Accented letters

More information

CSc Senior Project Writing Software Documentation Some Guidelines

CSc Senior Project Writing Software Documentation Some Guidelines CSc 190 - Senior Project Writing Software Documentation Some Guidelines http://gaia.ecs.csus.edu/~buckley/csc190/writingguide.pdf 1 Technical Documentation Known Problems Surveys say: Lack of audience

More information

FORMAT & TYPING GUIDE

FORMAT & TYPING GUIDE FORMAT & TYPING GUIDE for CEATI Reports updated March 2018 Timeline of a Report Pre-Writing As you sit down to write the report, ensure you begin by downloading the most recent CEATI template at www.ceati.com/rfps.

More information

SECTION 2: PUNCTUATION

SECTION 2: PUNCTUATION PUNCTUATION SECTION 2: PUNCTUATION This section will cover the use of: Commas Quotation Marks Hyphens 2 When to Use Commas% A comma is like a small pause in your sentence. Commas are often misused. Taking

More information

Technical Writing. Professional Communications

Technical Writing. Professional Communications Technical Writing Professional Communications Overview Plan the document Write a draft Have someone review the draft Improve the document based on the review Plan, conduct, and evaluate a usability test

More information

EDITING & PROOFREADING CHECKLIST

EDITING & PROOFREADING CHECKLIST EDITING & PROOFREADING CHECKLIST TABLE OF CONTENTS 1. Conduct a First Pass... 2 1.1. Ensure effective organization... 2 1.2. Check the flow and tone... 3 1.3. Check for correct mechanics... 4 1.4. Ensure

More information

Formal Figure Formatting Checklist

Formal Figure Formatting Checklist Formal Figure Formatting Checklist Presentation of Data Independent values are plotted on the x-axis, dependent values on the y-axis In general, no more than five curves to a figure (may be more or less

More information

WPPD Senior Pharmaceutical Care (PC) Paper Evaluation Student Name:

WPPD Senior Pharmaceutical Care (PC) Paper Evaluation Student Name: WPPD Senior Pharmaceutical Care (PC) Paper Evaluation Student Name: First Draft Evaluation by: Date Reviewed: THE SUBMITTED DRAFT FOR REVIEW BY UF EDITORIAL TEAM: is ACCEPTABLE pending final report with

More information

Brief Contents. PART 1 The Basics 1. PART 2 AP Style 35. PART 3 Punctuation and Usage 133

Brief Contents. PART 1 The Basics 1. PART 2 AP Style 35. PART 3 Punctuation and Usage 133 Brief Contents Preface xvii PART 1 The Basics 1 1. The Role of the Copy Editor 3 2. Editing Content 11 3. Copy Editing for Print and Online 19 4. Legal, Ethical and Inclusive-Language Concerns for Copy

More information

LONGWARE, Inc. Style Guide

LONGWARE, Inc. Style Guide [well, this is the most thorough style guide on that document I have ever seen. I sense that you have been around some style guides in your life. how about a revision for perfection?] LONGWARE, Inc. Style

More information

Technical Paper Style Guide

Technical Paper Style Guide AACE International Technical Paper Style Guide Prepared by the AACE International Technical Board Revised February 3, 2017 Contents 1. Purpose... 3 2. General Requirements... 3 2.1. Authorship... 3 2.2.

More information

Student Guide for Usage of Criterion

Student Guide for Usage of Criterion Student Guide for Usage of Criterion Criterion is an Online Writing Evaluation service offered by ETS. It is a computer-based scoring program designed to help you think about your writing process and communicate

More information

Mega International Commercial bank (Canada)

Mega International Commercial bank (Canada) Mega International Commercial bank (Canada) Policy and Procedures for Clear Language and Presentation Est. Sep. 12, 2013 I. Purposes: The Mega ICB (C) distributes a limited range of retail banking services,

More information

Editorial Style. An Overview of Hofstra Law s Editorial Style and Best Practices for Writing for the Web. Office of Communications July 30, 2013

Editorial Style. An Overview of Hofstra Law s Editorial Style and Best Practices for Writing for the Web. Office of Communications July 30, 2013 Editorial Style An Overview of Hofstra Law s Editorial Style and Best Practices for Writing for the Web Office of Communications July 30, 2013 What Is Editorial Style? Editorial style refers to: Spelling

More information

OUTLINE. Advanced Technical Communication & Writing Skills. What is technical communication? Technical communication skills

OUTLINE. Advanced Technical Communication & Writing Skills. What is technical communication? Technical communication skills Advanced Technical Communication & Writing Skills What is technical communication? Technical communication skills Principles of technical writing Technical writing is interpreting Planning is crucial Technical

More information

View and Submit an Assignment in Criterion

View and Submit an Assignment in Criterion View and Submit an Assignment in Criterion Criterion is an Online Writing Evaluation service offered by ETS. It is a computer-based scoring program designed to help you think about your writing process

More information

Standards Designation and Organization Manual

Standards Designation and Organization Manual Standards Designation and Organization Manual InfoComm International Standards Program Ver. 2014-1 April 28, 2014 Issued by: Joseph Bocchiaro III, Ph.D., CStd., CTS-D, CTS-I, ISF-C Director of Standards

More information

National Electrical Safety Code Manual of Style

National Electrical Safety Code Manual of Style National Electrical Safety Code Manual of Style Introduction The National Electrical Safety Code (NESC) is also known as American National Standard C2. It is a consensus standard that has been prepared

More information

The next several pages summarize some of the best techniques to achieve these three goals.

The next several pages summarize some of the best techniques to achieve these three goals. Writing and Reviewing Documents You are required to write the following documents in this course: 1) A description of your GPS data collection and results. 2) A technical description of a data collection

More information

Dissertation Formatting Rules. Basic Format

Dissertation Formatting Rules. Basic Format All doctoral students will follow APA (6 th edition) formatting for the narrative portion of the dissertation. Refer to this guide for rules specific to Missouri Baptist University dissertations. *Instructions

More information

WBJS Grammar Glossary Punctuation Section

WBJS Grammar Glossary Punctuation Section WBJS Grammar Glossary Punctuation Section Punctuation refers to the marks used in writing that help readers understand what they are reading. Sometimes words alone are not enough to convey a writer s message

More information

IMPLICIT RELIGION Guidelines for Contributors March 2007

IMPLICIT RELIGION Guidelines for Contributors March 2007 IMPLICIT RELIGION Guidelines for Contributors March 2007 Please follow these guidelines when you first submit your article for consideration by the journal editors and when you prepare the final version

More information

Paper Proof Manual. As a Student... Paper Proof Manual

Paper Proof Manual. As a Student... Paper Proof Manual Paper Proof consists of a large whiteboard region. Along the left hand side is the buttons bar. Details on the various button bar items will be given here. Along the top of the paper proof page is a tool

More information

ECC Style Guide. ECC Style Guide

ECC Style Guide. ECC Style Guide ECC Style Guide ECC Style Guide 23 November 2011 Page 2 0 EXECUTIVE SUMMARY This document provides guidance to introduce consistency across all Electronic Communications Committee (ECC) communications

More information

Detailed Format Instructions for Authors of the SPB Encyclopedia

Detailed Format Instructions for Authors of the SPB Encyclopedia Detailed Format Instructions for Authors of the SPB Encyclopedia General Formatting: When preparing the manuscript, the author should limit the use of control characters or special formatting. Use italics

More information

PROCEDIA CIRP Affiliated with CIRP, The International Academy for Production Engineering

PROCEDIA CIRP Affiliated with CIRP, The International Academy for Production Engineering .... PROCEDIA CIRP Affiliated with CIRP, The International Academy for Production Engineering AUTHOR INFORMATION PACK TABLE OF CONTENTS Description Editorial Board Guide for Authors XXX p.1 p.1 p.2 ISSN:

More information

GT48232/ME4182 First Progress Report & Presentation (Fall 2016)

GT48232/ME4182 First Progress Report & Presentation (Fall 2016) GT48232/ME4182 First Progress Report & Presentation (Fall 2016) The report clearly, concisely, and logically documents work to date including the process as well as the results. It is not a chronology

More information

Evaluation Department, Danida. Layout guidelines for evaluation reports

Evaluation Department, Danida. Layout guidelines for evaluation reports Layout guidelines for evaluation reports January 2016 1 1. Introduction These guidelines provide guidance on how to improve the presentation of findings (Section 2), and the layout to be applied to the

More information

Hotmail Documentation Style Guide

Hotmail Documentation Style Guide Hotmail Documentation Style Guide Version 2.2 This Style Guide exists to ensure that there is a consistent voice among all Hotmail documents. It is an evolving document additions or changes may be made

More information

Evaluation Department, Danida. Layout guidelines for evaluation reports

Evaluation Department, Danida. Layout guidelines for evaluation reports Layout guidelines for evaluation reports June 2013 1. Introduction These guidelines provide guidance on how to improve the presentation of findings (Section 2), and the layout to be applied to the different

More information

TITLE. Issuance type, number, Title, Publication Date

TITLE. Issuance type, number, Title, Publication Date ACTION OFFICER (AO) NOTES 1. The DoDEA Issuances Standards is the guiding document for the structure and composition of DoDEA issuances. References in this document are referring you to the DoDEA Issuance

More information

TE Teacher s Edition PE Pupil Edition Page 1

TE Teacher s Edition PE Pupil Edition Page 1 Standard 4 WRITING: Writing Process Students discuss, list, and graphically organize writing ideas. They write clear, coherent, and focused essays. Students progress through the stages of the writing process

More information

BAMSI Style and Editorial Guide. May 2011 Community Relations 10 Christy s Drive Brockton, MA 02301

BAMSI Style and Editorial Guide. May 2011 Community Relations 10 Christy s Drive Brockton, MA 02301 BAMSI Style and Editorial Guide May 2011 Community Relations 10 Christy s Drive Brockton, MA 02301 It is important that, as an agency, BAMSI is represented in a professional manner that demonstrates our

More information

GUIDE FOR AUTHORS PREPARING A MANUSCRIPT: INSTRUCTIONS FOR

GUIDE FOR AUTHORS PREPARING A MANUSCRIPT: INSTRUCTIONS FOR GUIDE FOR AUTHORS PREPARING A MANUSCRIPT: INSTRUCTIONS FOR AUTHORS Below you will find a fairly detailed description of how a paper to be submitted to Health Professions Education should look like. Attached

More information

Style template and guidelines for SPIE Proceedings

Style template and guidelines for SPIE Proceedings Style template and guidelines for SPIE Proceedings Anna A. Author1 a and Barry B. Author2 b a Affiliation1, Address, City, Country; b Affiliation2, Address, City, Country ABSTRACT This document shows the

More information

ewic: Information for Authors

ewic: Information for Authors ewic: Information for Authors 1st Author s name 2nd Author s name 3rd Author s name Author s affiliation Author s affiliation Author s affiliation Authors address Authors address Authors address Author

More information

Instructions for Using the Organic Letters Manuscript Template

Instructions for Using the Organic Letters Manuscript Template Instructions for Using the Organic Letters Manuscript Template Word 2010 for Windows The Organic Letters manuscript template is a guide to be used to prepare manuscripts for submission to Organic Letters.

More information

Federal Plain Language Guidelines

Federal Plain Language Guidelines Federal Plain Language Guidelines March 2011 Revision 1, May 2011 Table of Contents Introduction... i Revision 1 Changes... ii Table of Contents... iii I. Think about your audience... 1 a. Identify and

More information

13.1 End Marks Using Periods Rule Use a period to end a declarative sentence a statement of fact or opinion.

13.1 End Marks Using Periods Rule Use a period to end a declarative sentence a statement of fact or opinion. 13.1 End Marks Using Periods Rule 13.1.1 Use a period to end a declarative sentence a statement of fact or opinion. Rule 13.1.2 Use a period to end most imperative sentences sentences that give directions

More information

Word for Research Writing I: Text and Structure

Word for Research Writing I: Text and Structure Word for Research Writing I: Text and Structure Last updated: 10/2017 Shari Hill Sweet dteditor@nd.edu or 631-7545 1. The Graduate School Template...1 1.1 Document structure... 1 1.1.1 Beware of Section

More information

Dissertation Guidelines ARRANGEMENT OF THE DISSERTATION:

Dissertation Guidelines ARRANGEMENT OF THE DISSERTATION: Dissertation Guidelines ARRANGEMENT OF THE DISSERTATION: Each dissertation must be arranged in the following order. Specific information about each section is on the following pages. Italicized pages are

More information

TABLE OF CONTENTS PART I: BASIC MICROSOFT WORD TOOLS... 1 PAGE BREAKS... 1 SECTION BREAKS... 3 STYLES... 6 TABLE OF CONTENTS... 8

TABLE OF CONTENTS PART I: BASIC MICROSOFT WORD TOOLS... 1 PAGE BREAKS... 1 SECTION BREAKS... 3 STYLES... 6 TABLE OF CONTENTS... 8 TABLE OF CONTENTS PART I: BASIC MICROSOFT WORD TOOLS... 1 PAGE BREAKS... 1 SECTION BREAKS... 3 STYLES... 6 TABLE OF CONTENTS... 8 LIST OF TABLES / LIST OF FIGURES... 11 PART II: FORMATTING REQUIREMENTS:

More information

Correlation to Georgia Quality Core Curriculum

Correlation to Georgia Quality Core Curriculum 1. Strand: Oral Communication Topic: Listening/Speaking Standard: Adapts or changes oral language to fit the situation by following the rules of conversation with peers and adults. 2. Standard: Listens

More information

For proceedings contributors: general submission procedures and formatting guidelines for L A TEX2E users

For proceedings contributors: general submission procedures and formatting guidelines for L A TEX2E users 1 For proceedings contributors: general submission procedures and formatting guidelines for L A TEX2E users 1. Points to Remember (a) Please ensure quotation marks are paired correctly. (b) Italicized

More information

Electronic Production Guidelines

Electronic Production Guidelines Electronic Production Guidelines Illustrations It is a good idea to check out the draw programs you have available to you before you start drawing the figures for your article. Make sure that you can create

More information

FAO Online Style Guide Version 1.0

FAO Online Style Guide Version 1.0 FAO Online Style Guide Version 1.0 Last updated: May 2012 1 Introduction Consistency is an important way to make on-screen text clear and easy to read. This Guide defines consistent Web writing recommendations,

More information

WHY EFFECTIVE WEB WRITING MATTERS Web users read differently on the web. They rarely read entire pages, word for word.

WHY EFFECTIVE WEB WRITING MATTERS Web users read differently on the web. They rarely read entire pages, word for word. Web Writing 101 WHY EFFECTIVE WEB WRITING MATTERS Web users read differently on the web. They rarely read entire pages, word for word. Instead, users: Scan pages Pick out key words and phrases Read in

More information

Lesson 2 Writing Business Reports. Henan University of Technology Sino-British College Transfer Abroad Undergraduate Programme

Lesson 2 Writing Business Reports. Henan University of Technology Sino-British College Transfer Abroad Undergraduate Programme Lesson 2 Writing Business Reports Henan University of Technology Sino-British College Transfer Abroad Undergraduate Programme Learning Objectives 1. Explain report functions and types 2. Apply the 3-x-3

More information

Defense Logistics Agency INSTRUCTION

Defense Logistics Agency INSTRUCTION Defense Logistics Agency INSTRUCTION Subject: Plain Language Program References: DLAI 5025.13 Effective September 10, 2015 Accountable Office: Headquarters Complex Strategic Plans and Policy, Policy Management

More information

Starting-Up Fast with Speech-Over Professional

Starting-Up Fast with Speech-Over Professional Starting-Up Fast with Speech-Over Professional Contents #1 Getting Ready... 2 Starting Up... 2 Initial Preferences Settings... 3 Adding a Narration Clip... 3 On-Line Tutorials... 3 #2: Creating a Synchronized

More information

AMENDMENTS TO THE GUIDELINES FOR DRAFTING CLASSIFICATION DEFINITIONS

AMENDMENTS TO THE GUIDELINES FOR DRAFTING CLASSIFICATION DEFINITIONS ANNEX VI AMENDMENTS TO THE GUIDELINES FOR DRAFTING CLASSIFICATION DEFINITIONS GENERAL RECOMMENDATIONS Users are expecting to find in definitions additional explanation and guidance that are not available

More information

19. Bulleted and Numbered Lists

19. Bulleted and Numbered Lists Kennesaw State University DigitalCommons@Kennesaw State University Sexy Technical Communications Open Educational Resources 3-1-2016 19. Bulleted and Numbered Lists David McMurray Follow this and additional

More information

FACULTY OF ENGINEERING SCIENCE. Written and oral reporting Guidelines for engineering students

FACULTY OF ENGINEERING SCIENCE. Written and oral reporting Guidelines for engineering students FACULTY OF ENGINEERING SCIENCE Written and oral reporting Guidelines for engineering students Contents 1 Written communication... 4 1.1 Basic steps in the writing process... 5 1.2 Report writing: structure

More information

A GUIDE TO WRITING TECHNICAL REPORTS

A GUIDE TO WRITING TECHNICAL REPORTS A GUIDE TO WRITING TECHNICAL REPORTS Faculty of Engineering and Applied Science Memorial University of Newfoundland Abstract This guide is designed to help you learn how to format and organize a formal

More information

Contents. Contents iii

Contents. Contents iii Contents iii Contents Topical Guide vi Preface xi Part 1: Web Writing and Design Principles 1 Comparing Online and Print Documents 2 Understanding the Writing Process 2 Writing For Your Audience 3 Providing

More information

2018 Marketer Publication & Editorial Guidelines

2018 Marketer Publication & Editorial Guidelines 2018 Marketer Publication & Editorial Guidelines About Marketer, the Journal of SMPS First published in 1981, Marketer is the only industry publication created specifically to educate, enlighten, and inform

More information

analysis by Kendra Charles WORD COUNT 723 CHARACTER COUNT 3463 PAPER ID

analysis by Kendra Charles WORD COUNT 723 CHARACTER COUNT 3463 PAPER ID analysis by Kendra Charles WORD COUNT 723 CHARACTER COUNT 3463 TIME SUBMITTED 12-APR-2012 11:53PM PAPER ID 241863456 " " 1 2 3 " " Delete ww Contractions ww concis ww concis Contractions coh 4 concis w

More information

Interdisciplinary Journal of Best Practices in Global Development Final Manuscript Preparation Guidelines

Interdisciplinary Journal of Best Practices in Global Development Final Manuscript Preparation Guidelines Interdisciplinary Journal of Best Practices in Global Development Final Manuscript Preparation Guidelines This document provides details on typesetting and layout requirements pertaining to final manuscript

More information

Guidelines & Instructions for Manuscript Preparation

Guidelines & Instructions for Manuscript Preparation Distributor of Scholarly Books Guidelines & Instructions for Manuscript Preparation or How to Get your Book Published and Make your Production Team Happy 1 2 important Please make sure that your manuscript

More information

Follow this and additional works at: Part of the Technical and Professional Writing Commons

Follow this and additional works at:   Part of the Technical and Professional Writing Commons Kennesaw State University DigitalCommons@Kennesaw State University Sexy Technical Communications Open Educational Resources 3-1-2016 15. Report Design David McMurray Jonathan Arnett Kennesaw State University,

More information

Readers are wary of out of date content, so it's important to actively manage the information you publish.

Readers are wary of out of date content, so it's important to actively manage the information you publish. Web Style Guide Important tips for writing for the web People don t usually read for pleasure on the website. They are looking for a specific piece of information, and they don't want extraneous junk to

More information

Instructions/template for preparing your NOLTA manuscript (Ver. 3.02, Aug. 28, 2015)

Instructions/template for preparing your NOLTA manuscript (Ver. 3.02, Aug. 28, 2015) NOLTA, IEICE Paper Instructions/template for preparing your NOLTA manuscript (Ver. 3.02, Aug. 28, 2015) Name Author1 1a), Name Author2 2, and Name Author3 1 1 Institute of Industrial Science, University

More information

Report Template. Joe B. Student and Dan Simon * Department of Electrical and Computer Engineering Cleveland State University Cleveland, Ohio 44115

Report Template. Joe B. Student and Dan Simon * Department of Electrical and Computer Engineering Cleveland State University Cleveland, Ohio 44115 Joe B. Student and Dan Simon * Department of Electrical and Computer Engineering Cleveland State University Cleveland, Ohio 44115 May 20, 2004 Abstract Every report should have an abstract. The abstract

More information

Analyzing PDFs with Citavi 6

Analyzing PDFs with Citavi 6 Analyzing PDFs with Citavi 6 Introduction Just Like on Paper... 2 Methods in Detail Highlight Only (Yellow)... 3 Highlighting with a Main Idea (Red)... 4 Adding Direct Quotations (Blue)... 5 Adding Indirect

More information

ISAE2013 Conference Proceedings Format Sample File

ISAE2013 Conference Proceedings Format Sample File ISAE2013 Conference Proceedings Format Sample File First AUTHOR 1, Second M. AUTHOT 2, Third AUTHOT 3 1,2 Affiliation Address 1,2 e-mail address 3 Affiliation Address 3 e-mail address ABSTRACT: In this

More information

Meridian Linguistics Testing Service 2018 English Style Guide

Meridian Linguistics Testing Service 2018 English Style Guide STYLE GUIDE ENGLISH INTRODUCTION The following style sheet has been created based on the following external style guides. It is recommended that you use this document as a quick reference sheet and refer

More information

Holistic Punctuation Chart

Holistic Punctuation Chart WRITING WORKSHOP#2 almost everything you need to know about punctuation but were afraid to ask AKA: commas, dashes, semicolons, quotation marks, and colons Holistic Punctuation Chart Holistic Punctuation

More information

GRADES LANGUAGE! Live, Grades Correlated to the Oklahoma College- and Career-Ready English Language Arts Standards

GRADES LANGUAGE! Live, Grades Correlated to the Oklahoma College- and Career-Ready English Language Arts Standards GRADES 4 10 LANGUAGE! Live, Grades 4 10 Correlated to the Oklahoma College- and Career-Ready English Language Arts Standards GRADE 4 Standard 1: Speaking and Listening Students will speak and listen effectively

More information

Design Proposal: Outline

Design Proposal: Outline Design Proposal: Outline This outline should be used as a checklist to help each member of the team make sure that every section of the document meets the requirements for a design proposal. Writing Style

More information

Word for Research Writing I: Text and Structure

Word for Research Writing I: Text and Structure Word for Research Writing I: Text and Structure Last updated: 12/2017 Shari Hill Sweet dteditor@nd.edu or 631-7545 1. The Graduate School Template... 1 1.1 Document structure... 1 1.1.1 Beware of Section

More information

TITLE. Issuance type, number, Title, Publication Date

TITLE. Issuance type, number, Title, Publication Date ACTION OFFICER (AO) NOTES 1. The DoDEA Issuances Standards is the guiding document for the structure and composition of DoDEA issuances. Citations in this document refer to the DoDEA Issuance Standards

More information

Joint Steering Committee for Development of RDA. The attached document contains the guidelines followed by the Editor in drafting RDA.

Joint Steering Committee for Development of RDA. The attached document contains the guidelines followed by the Editor in drafting RDA. 28 October 2008 To: From: Subject: Joint Steering Committee for Development of RDA Deirdre Kiorgaard, Chair, JSC RDA Editor s Guide The attached document contains the guidelines followed by the Editor

More information

Guidelines for Authors (full paper submissions)

Guidelines for Authors (full paper submissions) Guidelines for Authors (full paper submissions) file format Please save your document Microsoft Word 97-2003 document (.doc) or (.docx). word-count Your submission must not exceed 3,000 words exclusive

More information

In Practice Guidance for Authors

In Practice Guidance for Authors In Practice Guidance for Authors In Practice is the quarterly publication of the Chartered Institute of Ecology and Environmental Management (CIEEM), the professional body that represents and supports

More information

Writer 5.4 Guide. Chapter 12 Lists: Tips and Tricks

Writer 5.4 Guide. Chapter 12 Lists: Tips and Tricks Writer 5.4 Guide Chapter 12 Lists: Tips and Tricks Copyright This document is Copyright 2017 by the LibreOffice Documentation Team. Contributors are listed below. You may distribute it and/or modify it

More information

Formatting and content guidelines for unit standard change reports to be published on the NZQA website

Formatting and content guidelines for unit standard change reports to be published on the NZQA website Formatting and content guidelines for unit standard change reports to be published on the NZQA website Introduction This guide is to be used in conjunction with the report template published in August

More information

MASTER OF EDUCATION STYLE GUIDE: A CLARIFICATION OF THE SIXTH ED. APA PUBLICATION MANUAL

MASTER OF EDUCATION STYLE GUIDE: A CLARIFICATION OF THE SIXTH ED. APA PUBLICATION MANUAL MASTER OF EDUCATION STYLE GUIDE: A CLARIFICATION OF THE SIXTH ED. APA PUBLICATION MANUAL November, 2011 STYLE GUIDE 2 Master of Education follows the APA Publication Manual, 6 th Edition. This style guide

More information

BFPA CONFERENCE- POWERPOINT PRESENTATION FORMAT

BFPA CONFERENCE- POWERPOINT PRESENTATION FORMAT BFPA CONFERENCE- POWERPOINT PRESENTATION FORMAT These guidelines are designed to help you prepare a successful conference presentation. PREPARING YOUR POWERPOINT PRESENTATION Please note the following:

More information

Click here, type the title of your paper, Capitalize first letter

Click here, type the title of your paper, Capitalize first letter Available online at www.sciencedirect.com Physics Procedia 00 (2016) 000 000 www.elsevier.com/locate/procedia 8th International Topical Meeting on Neutron Radiography, ITMNR-8, 4-8 September 2016, Beijing,

More information

Word 2010: Preparing Your Dissertation. May 18, 2011

Word 2010: Preparing Your Dissertation. May 18, 2011 Word 2010: Preparing Your Dissertation May 18, 2011 Author: Anne Kolaczyk, Maureen Hogue Editor: Maureen Hogue, Anne Kolaczyk, Susan Antonovitz 2008, 2010. 2011 Office of Information Technologies, University

More information

MARKET RESEARCH AND EVALUATION2017. Reporting Guidelines

MARKET RESEARCH AND EVALUATION2017. Reporting Guidelines MARKET RESEARCH AND EVALUATION2017 Reporting Guidelines July 25, 2017 At NEEA, we are dedicated to providing strategic and relevant insight to our primary audiences through market research and evaluation

More information

POFT 2301 INTERMEDIATE KEYBOARDING LECTURE NOTES

POFT 2301 INTERMEDIATE KEYBOARDING LECTURE NOTES INTERMEDIATE KEYBOARDING LECTURE NOTES Be sure that you are reading the textbook information and the notes on the screen as you complete each part of the lessons in this Gregg Keyboarding Program (GDP).

More information

Click here, type the title of your paper, Capitalize first letter

Click here, type the title of your paper, Capitalize first letter Available online at www.sciencedirect.com Transportation Research Procedia 00 (2016) 000 000 www.elsevier.com/locate/procedia INTERNATIONAL SYMPOSIUM ON TRAFFIC AND TRANSPORTATION THEORY ISTTT22 Click

More information

o Changes that require author intervention, e.g., address/ requirements and/or missing sections, should be conveyed through remarks.

o Changes that require author intervention, e.g., address/ requirements and/or missing sections, should be conveyed through remarks. This document covers all Formatting-related points to be adhered to by all Enago Professional Editors when an author opts for Formatting. This is conveyed through the assignment email as Formatting: Yes,

More information

Restricted Use Case Modeling Approach

Restricted Use Case Modeling Approach RUCM TAO YUE tao@simula.no Simula Research Laboratory Restricted Use Case Modeling Approach User Manual April 2010 Preface Use case modeling is commonly applied to document requirements. Restricted Use

More information

Office Wo Office W r o d r 2007 Revi i ng and R d Refifini ng a D Document

Office Wo Office W r o d r 2007 Revi i ng and R d Refifini ng a D Document Office Word 2007 Lab 2 Revising i and Refining i a Document In this lab, the student will learn more about editing documents They will learn to use many more of the formatting features included in Office

More information

WRITING FOR THE WEB. UIUC Web Governance

WRITING FOR THE WEB. UIUC Web Governance WRITING FOR THE WEB UIUC Web Governance HOW USERS READ ON THE WEB UIUC Web Governance Scan text instead of reading word by word Often hurried, looking for something specific or wanting to complete a task

More information

Mn/DOT Market Research Reporting General Guidelines for Qualitative and Quantitative Market Research Reports Revised: August 2, 2011

Mn/DOT Market Research Reporting General Guidelines for Qualitative and Quantitative Market Research Reports Revised: August 2, 2011 Mn/DOT Market Research Reporting General Guidelines for Qualitative and Quantitative Market Research Reports Revised: August 2, 2011 The following guidelines have been developed to help our vendors understand

More information

English 303 Rubric. Error Points. Marking Errors. Writing Corrections

English 303 Rubric. Error Points. Marking Errors. Writing Corrections Recall that an "A" paper is excellent. It is difficult to improve. It is submitted on time and demonstrates insight, originality, and attention to detail. It adheres to American English grammar and usage.

More information

Information Technologies University of Delaware

Information Technologies University of Delaware Information Technologies University of Delaware Microsoft Word UDThesis Styles For Dissertations, Executive Position Papers, Master Theses, and Senior Theses Introduction The UDThesis Styles are Word files

More information

FedRAMP General Document Acceptance Criteria. Version 1.0

FedRAMP General Document Acceptance Criteria. Version 1.0 Version 1.0 July 30, 2015 Revision History Date Version Page(s) Description Author 03/12/ 2015 0.6 All Draft Steve Levitas 05/05/2015 0.7 All Incorporated Monette Respress comments about acceptability

More information

RDA Editor s Guide. 2.1 Chapter numbers 2.2 Section numbers. 4.1 Hyphens and dashes 4.2 Lists 4.3 Examples

RDA Editor s Guide. 2.1 Chapter numbers 2.2 Section numbers. 4.1 Hyphens and dashes 4.2 Lists 4.3 Examples RDA Editor s Guide Contents 1. Purpose and scope 2. Numbering 2.1 Chapter numbers 2.2 Section numbers 3. Capitalization 4. Punctuation 5. Spelling 3.1 Chapter titles 3.2 Section titles 3.3 Paragraphs 3.4

More information

The Baptist College of Florida. MLA Formatting Guide

The Baptist College of Florida. MLA Formatting Guide The Baptist College of Florida MLA Formatting Guide Spring 2018 Table of Contents Overview of an MLA Paper... 1 Creating a template for research papers... 2 Changing Word s default settings... 3 Change

More information

2019 Marketer Publication & Editorial Guidelines

2019 Marketer Publication & Editorial Guidelines 2019 Marketer Publication & Editorial Guidelines About Marketer, the Journal of SMPS First published in 1981, Marketer is the only industry publication created specifically to educate, enlighten, and inform

More information

MLA Format. Example and Formatting Instructions. Prepared by the Clarendon College English Department and Computer Science Department

MLA Format. Example and Formatting Instructions. Prepared by the Clarendon College English Department and Computer Science Department MLA Format Example and Formatting Instructions Prepared by the Clarendon College English Department and Computer Science Department Example MLA Format Fleming 1 John Fleming Professor Daniels ENGL 1301

More information

Web Site Documentation Eugene School District 4J

Web Site Documentation Eugene School District 4J Eugene School District 4J Using this Documentation Revision 1.3 1. Instruction step-by-step. The left column contains the simple how-to steps. Over here on the right is the color commentary offered to

More information

XRM2018 Paper Preparation and Submission Guide

XRM2018 Paper Preparation and Submission Guide XRM2018 Paper Preparation and Submission Guide Welcome to the XRM2018 Meeting paper website. XRM2018 paper submission is entirely electronic; do not mail hard-copy printouts. All papers, whether invited

More information

Author s GUIDELINES MINING WITH BACKFILL. th International Symposium on THIS GUIDE. #societyformining

Author s GUIDELINES MINING WITH BACKFILL. th International Symposium on THIS GUIDE.   #societyformining THIS GUIDE Held in conjunction with HAS BEEN DESIGNED TO HELP YOU PREPARE FOR YOUR PAPER FOR THE th INTERNATIONAL SYMPOSIUM ON www.smenet.org #societyformining Title of Your Paper Subtitle Here If You

More information

Cambrian College Online Course Review Checklist

Cambrian College Online Course Review Checklist Course Code: Instructor: Reviewed By: Cambrian College Online Course Review Checklist Course Name: Date Reviewed: Instructions: The criteria in the Checklist reflect design principles required for all

More information