



Study with the several resources on Docsity
Earn points by helping other students or get them with a premium plan
Prepare for your exams
Study with the several resources on Docsity
Earn points to download
Earn points by helping other students or get them with a premium plan
Community
Ask the community for help and clear up your study doubts
Discover the best universities in your country according to Docsity users
Free resources
Download our free guides on studying techniques, anxiety management strategies, and thesis advice from Docsity tutors
Guidelines for writing effective technical reports in science. It covers organization at the whole-report, section, paragraph, and sentence levels, the importance of clear and concise writing, and the use of passive voice. It also includes examples and references.
Typology: Lecture notes
1 / 7
This page cannot be seen from the preview
Don't miss anything!
The purpose of technical writing is to convey information as efficiently as possible. Technical reports generally are not read for the sake of entertainment, but for the purpose of obtaining information. Technical writing is not colorful, and nor does it use exaggeration. Technical writing is well organized; significant findings are not hidden at the end as a surprise to the reader. It is best to give the reader the important conclusions as soon as the reader has learned enough to appreciate them. The rest of the paper should then be written to justify and amplify the conclusions. In order to simplify the writing process, an efficient way to begin organizing a report is to write down the important conclusions of the report. Next, fill in the other information that the reader will have to be told to understand the conclusions. Written and oral communication abilities are some of the most important skills that you should obtain at MTU; honing those skills is the primary objective of the lab reports in this class.
B1. ORGANIZATION Organization is an essential element of good writing that contributes to readability. Four levels of organization must be considered in every written report: the whole-report level, the section level, the paragraph level, and the sentence level. You will have no options on the whole-report organization; there is a required format that you are to follow (either the memo format or the lab report format) as is explained below in this handout. Each section of your report has a function; you must organize the material in that section such that it achieves that function, reads smoothly, and is as short as practicable. Each section is likely to consist of one or more paragraphs; in cases of multiple paragraphs, these must be strung together such that there is a logical sequence of topics. Paragraph structure is, perhaps, the most often neglected element of organization. However, paragraph structure is as important as sentence structure. A paragraph typically has one theme ; generally, this theme is identified in the opening sentence of the paragraph. Generally, either the first or the final sentence of a paragraph gives the conclusion or the message that the reader is intended to remember about that topic. The sentences in between the opening and closing lines must develop the theme (identified in the first sentence) and lead the readers to the conclusion. Paragraphs should consist of at least three sentences , but should not be so long that the reader cannot remember the beginning or the sequence of ideas. Sentence structure in technical writing can become very awkward unless care is used. Sometimes sentences become too long. Usually a long sentence can be broken into two or more short sentences. One way of insuring that your writing is readable is to read aloud what you have written. This technique often will reveal grammatical errors and the need for punctuation as well. Another common problem in sentence formation is the sentence fragment. Every sentence must have a subject and a verb within the body. The technique of reading out loud also will help to locate incomplete sentences. In this class and some subsequent classes, you will use either a "short" or a "long" report format. The short format is that of a memo; the primary purpose of the memo is to convey the results and conclusions. Memos are the common, every-day method of communication of factual information in the work place. The longer report format
typically is used at the conclusion of an engineering or scientific project. You will be told for which lab exercises you are to use the memo and the long format.
B1a. Memo format A memo is a 1-2 page communication. Although brevity is important, grammar and syntax are not to be sacrificed. Apart from the Header, the sections of the memo are not usually given title lines; each section will comprise one or more paragraphs. The memo report will have the following sections:
B1b. Full report format There are several slight variations on the standard format for a lab report, but all are similar. A lab report may vary from two to fifty or more pages in length. The tight organization of the report allows the reader to easily find all information that is necessary to interpret the results. The format that you will follow is summarized below.
“They believe the reason....” (when they isn’t clear) should be avoided. Even “Most engineers regard...” is not good unless the statement is documented.
B3. CONCISENESS: Reports should be as concise as is consistent with being complete and unambiguous. Most readers are busy people. They do not want to be burdened with thicker reports than necessary. Concise writing requires some assumption about the level of the reader. For the purposes of this course, the reader is the graduate student in charge of the lab or the instructor. Imagine these people to be your bosses in an environmental engineering consulting firm. In describing laboratory procedures, it is not necessary to go into detail about every step unless nonstandard techniques were used. Avoiding excessive verbiage requires practice and usually revision of the first draft. Some examples of how writing can be condensed follow.
Rewritten “A 10 pound ingot of a copper-21% aluminum alloy was prepared from metal by melting in a clay-graphite crucible in a gas-fired furnace. Stirring and superheating to 1150°C insured homogeneity and sufficient fluidity for casting...”
Rewritten “One liter of 0.1 M (+0.025) solution of potassium thiocyanate (KSCN) was prepared and titrated against a silver nitrate (AgNO 3 )
standard in an acidic medium with ferric ammonium sulfate indicator. To determine the endpoint, AgNO 3 was added until the red-brown color was permanent for 1 minute. The pH was adjusted with concentrated nitric acid.”
Note that the rewritten versions are shorter and actually give more information. The reader will assume the weighing steps from the body of text. The reader will also assume the placing of metal in the crucible, and the dissolution of KSCN in water. The reader should also know standard titration techniques (if not, refer the reader to an appendix which goes through step-by-step instructions). Furthermore, neither example hides what is being done (preparation of an ingot, determination of a solution concentration).
Statements of fact as well as descriptions of past work should be referenced so that the reader can, if she/he wishes, check these. This is done by inserting a number in the text at the appropriate place. The number corresponds to the number of the reference in a separate reference section. The number may be in (1) or [2] or it may be superscripted^3 , but placed in the text where it will be clear to the reader what statement is being referenced. The numbers of the reference should be sequential, (1) referring to the first citation in the text, (2) to the second, etc. An alternative style is to have the authors and date in parentheses in the text of the report following the information that has been cited rather than using numbers for each citation. In the reference section, the authors, the source, the date, and the pages should be given. Only those references specifically cited in the text should be listed. Below is an example of a portion of text and the corresponding reference section.
Research report excerpt:
“In a recent study, Nesbitt et al. (1) investigated the effect of thiourea as a sulfide donor in the removal of metal contaminants from water by precipitation as sulfides. The results of this investigation were the development of two processes that have direct industrial application. The study showed that copper, zinc, lead, cadmium, and mercury would be removed as metal sulfides. The results give credence to Pearson’s Hard-Soft Acid-Base Theory (2) which predicts that each of these metals would combine with sulfur over any other species. Many analytical procedures were used in this study. The atomic absorption spectrophotometer (see Ref. 3 for details of the analytical technique and flame conditions) was used for metal ion determination. Electron microscopic techniques (4) were employed for determining precipitate composition and structure.”
References
If the author is unknown, the citation should start with the title of the work, e.g.
B5. FIGURES: Figures include photographs, graphs, schematic drawings and other visual material. A Table is not a Figure! Figures should be numbered in the order to which they are referred in the text. They should appear either at the end of the paper (in a Figures section) or as soon after they are cited as convenient (preferable). All figures should be cited somewhere in the text. Every figure should have a caption written below the figure, which is a title and as much of a description as can be concisely given. (A little redundancy with the text does not hurt.) As a general rule, one should put enough information in the title and description so that if the figure is viewed without the report it can be understood. In other words, it should be able to stand on its own. For a graph, one should try to avoid using the axes labels in the description. For example rather than to give a plot of pH versus concentration the title “Concentration as a Function of pH for Silver Nitrate”, it would be better to use “Titration Curve of Silver Nitrate”. With the software that is readily available to all of us there is little excuse for producing anything but high quality graphs and figures. Some simple rules include:
B6. TABLES: Frequently the best way to present data is in the form of a table. As are figures, tables should be sequentially numbered (usually with Roman numerals) in the order that they are used in the text, and titles should be given above the table. Tables should appear at the end of the paper or as soon after the reference to them as is convenient.
B7. SUMMARY: Reports should be written with the reader in mind. The writing should be concise, but unambiguous and complete. A summary is a useful way to put important information together in one spot.