Formal Written ReportsAbout this chapterThis chapter provides an overview of two styles of writing as well as the necessary organizational and stylistic components of laboratory reports and technical papers. The next section contains organization information including comprehensive formatting information; word processor settings (e.g., margins, headers & footers, typefaces [a.k.a. "fonts"], etc.), tables, figures, and computer source code. The mechanics of APA-style citations, quotations, and list of references are then covered. The chapter concludes with a list of DOs and DON'Ts and a checklist to help you determine the strengths and weaknesses of your lab reports and technical papers. What separates an 'A' Paper from a 'D' or 'F' paper?Basically...diligence, thought, effort, and practice. And, oh, yes, lots and lots of revisions. Writing to Learn vs. Writing to CommunicateWriting is one of the most powerful skills you will develop during your educational experience. You are probably most familiar with the "writing to communicate" type of assignment: a four to five page term paper that, typically, will be read only by your instructor and counted as some percentage of your final grade. Although such writing assignments are frequently perceived as "busy work" by students, they should be a meaningful part of the learning experience. Researching, organizing, and drafting papers are active processes that help you better understand the material and complement the experiences of classroom lectures and discussions. During this phase of the writing process, you are in a position of trying to explain the material only to yourself. This type of discovery writing, therefore, may be called "writing to learn." The basic concept is to first gather facts and ideas together and then begin a period of critical analysis. The end result of this analysis will be a draft paper with the major issues organized into some logical and understandable form. It is later during the iterative revision process of reading, editing, and proofreading that you should change your focus and switch to the "writing to communicate" mode. The goal of writing to communicate is to involve a reader in his or her own process of discovery. As a writer, your responsibility shifts from gathering and organizing facts to presenting facts and inferences in the most efficient manner. When the communication is successful, you become a sincere authority on the subject matter. However, your sincerity and authority must extend far beyond a believable recitation of documented fact and reasonable inference; the details of grammar, usage, and style also become important. Readers expect a "reader friendly" document; deviations from standard English (grammar and usage, spelling, etc.) will diminish the communication effort. Writing to learn and writing to communicate are both integral parts of the writing process. It is very hard to achieve excellence in the latter without putting forth major time and effort in the former. Experience with students has shown that when sufficient effort and time is invested in both types of writing, the quality of work will always be higher. The more you thoughtfully practice writing, the sharper your skills will become. This investment will yield rich rewards. |
|
Laboratory Reports vs. Technical PapersMost of the university writing assignments you will have outside the core English composition classes will primarily be one of two types: laboratory reports or technical papers. What is the difference? It is basically one of format and length. The following sections provide standards for content and style for laboratory reports and technical papers submitted within the College of Applied Science and Technology. It is important to note that various academic units outside the College have their own standards for content and style for both of these types of technical writing; it is the student's responsibility to ensure that they follow the appropriate rules. Details of presentation and style not otherwise covered in this handbook may be found in references such as the Publication Manual of the American Psychological Association or The Blair Handbook. Remember the audienceA writer should never forget his or her audience. Reports and papers are written to be read. Above all, the student should identify an audience and develop the paper to reflect the needs of that audience. Such needs include: the level at which the material will be covered, the scope of the coverage, an appropriate writing style, a logical flow of ideas, consistency of form, and a basis in documented fact. One good way a writer can ensure a document is "audience friendly" is to simply have the paper read out loud either by the writer or by a friend. Listen to the words as well as to the flow of words. Papers that do not "sound right" or that cause the reader to "stumble" over the words need more work. Well written reports and papers will not only sound correct but will be easily followed. Laboratory reportsYou may have heard this statement before from numerous instructors: "Laboratory assignments are an integral part of the learning experience." Why? There are two theories. The first is that students learn more in labs because they tend to stay awake. Or, more seriously, the hands-on nature of lab experiences reinforces theoretical foundations, thus making subject matter more interesting and understandable. OK, so what's the purpose of lab reports? Again, there are two theories. The first is to prove you were in class. The second is to help you learn effective and efficient communication methods for data collection, analysis, and presentation; determination and execution of procedures; development of requirements definitions; etc. Mastering these skills is no trivial task and that is what makes a lab report basically a wonderful vehicle of guided self-instruction. That and the fact that professors are quieter during labs and we know that's a also good thing. Lab reports force you to communicate a problem or task, bring to light any problems you had, and announce any discoveries you made to the technical community. A lab report may therefore be defined as a brief yet formal mechanism for reporting facts and/or demonstrating some form of technical competency in a particular field of practice. Common examples of laboratory reports that most students will encounter during their academic career include:
In a technical environment (a.k.a. your real job), this same report format is how you will most likely communicate with your employer or customers. Often, you will be asked to creat technical proposals, status reports, product evaluations, or operating instructions; all of which use the same basic skills as, you guessed it, your lab reports. You should therefore write your lab reports as if your instructor is your employer and your pay, promotions, and overall happiness depended on his of her impression of your performance. How will your instructor form an impression of you? Through your writing! Laboratory reports may include any or all of the following:
Musts, Must Nots, and Suggestions for Lab ReportsThe following is a list of some "musts", "must nots", and suggestions for your basic lab reports. Musts:
Must Nots (a.k.a. Dont's):
Suggestions:
Technical papersA technical paper is defined for the purposes of this handbook as a formal, multi-page, primarily text-based document used to present facts or concepts to an identified reader. The most familiar example of a technical paper would be the basic five to ten page double-spaced research paper required for a particular class. Realistically, students may define a technical paper as any "long" writing assignment. All technical papers should have the following features:
Preparation and planning go a long way towards ensuring that any technical paper succeeds in its mission: guarantee communication. The following sections cover many topics of interest to a writer. |
|
OrganizationMany students report that a major problem encountered in the writing process is the organization of material. Organization is an important step that requires conscientious planning. If done properly, it helps balance critical elements in the paper and provides readers with what they need to know in the proper sequence. Poor organization usually leads to other writing problems such as lack of clarity and conciseness. Paper organization consists of a title page, abstract, table of contents, body, and references. The abstract and table of contents are optional for shorter papers. Content and style should follow accepted standards described in the Publication Manual of the American Psychological Association, Fourth Edition; The Blair Handbook, section 61d; or a standard specified by your instructor. Consistent style will reinforce the organization of a report and must therefore be used throughout the paper. Details of the format are given in a following section. All papers submitted as course assignments must, at a minimum, be typed or printed from a word processor in a "letter quality" mode. Final copy of formal reports cannot be handwritten. Of course, many students find that during any number of phases in the writing process, they prefer to develop their thoughts using pen and paper. Such a writing style may be most suitable to contemplative writers who find that they best use their time organizing their thoughts within before putting them down on paper. Others may simply sit down in front of a computer and start typing. No matter what the writing style, most writers find that by using a particular methodology of writing, they are able to maximize their efforts. Such a method typically consists of
Good writing is an iterative process of writing, reviewing, editing, and revising. Outlines can be extremely helpful during the writing process. Writing is not usually a "sequential" process. Starting a paper based around a dynamic outline will help keep the paper flowing in a logical progression. The use of a computer is not just highly recommended; it is expected. In fact, you should learn to use a computer or dedicated word processor very early in your educational career. A word processor should not be viewed as a mere productivity aid. Effective communication requires quality. Writers seldom, if ever, simply sit down and create a quality report. The quality of a report is reflected in the number of revisions a writer is willing to make. Using a word processor will greatly increase the number of revisions in a given period of time, thus increasing the quality of a report. Additionally, word processing skills are now expected by employers. Without such skills, a student will be at a competitive disadvantage when seeking employment. Order of the PagesThe following sequence of pages is to be used for papers submitted as course assignments within the College. However, an instructor may modify the options to meet specific course or paper requirements. For example, a very short paper may not require a table of contents. Similarly, book reviews and abstracts may follow some other format suitable for the article or book being reviewed. The title page includes the title, the author, and the author's affiliation. The title is centered on the page and typed in mixed-case letters with the first letter of each significant word in the title capitalized. If the title is more than one line, it should be double-spaced. The name of the author is typed in uppercase and lower-case letters, centered on the page, one double-spaced line below the title. Centered near the bottom of the page is the department and course number, East Tennessee State University, and the date of submission. An abstract is optional as determined by instructor and, if used, is a brief, comprehensive survey of the paper's contents. The abstract states the problem, describes the procedures used, and states the main results or conclusions of the investigation. The abstract must not exceed one page. The maximum length of the abstract can vary from 150 words (APA) to 250 (ETSU Graduate School). A table of contents is optional as determined by the instructor and is ordinarily used only with papers longer than 20 pages. The table of contents is placed immediately after the abstract and contains a listing of all the materials that follow. All entries and page citations must correspond exactly with the text. The body of the paper then follows. The organization of the body is very important. For most technical papers, an Introduction-Topics-Conclusion format is probably best. The introduction must be an overview of the entire paper and must gain the reader's attention and lead smoothly into the statement of the problem. The problem statement must be included in the introduction and must state clearly the purpose of the paper. The body must be structured with appropriately organized topics and must lead to a definite conclusion. Tables, figures, and graphical images should be incorporated into the body of the document immediately after they are referenced. The stylistic details are covered below. Optional appendices may be used in long technical papers for presenting additional information not appropriate for inclusion in the body of the paper. This includes items such as source code listings for computer programs, presentation of "raw" data, etc. Each appendix should be sequentially labeled using uppercase letters (e.g., Appendix A) and given a brief descriptive title. |
|
Page Layout and Formatting InformationThe following page layout and formatting conventions are to be used for all technical papers submitted as course assignments within the College of Applied Science and Technology. The instructor, however, may modify the options to meet specific course or paper requirements. Similarly, other groups (departments outside the College of Applied Science and Technology, the School of Graduate Studies, etc.) may dictate other format criteria for submitted work. When in doubt, ask your instructor. PaperThe paper should be neat with no ragged edges, on heavy (20 lb.) white bond paper 8 1/2 x 11 inch using one side only. Do not use onion skin or erasable paper as they tend to tear or smear when handled. The pages should be stapled in the upper left corner. Binders or folders are unnecessary. Do not use blank pages to separate sections. Use a cover sheet unless your instructor states otherwise. Settings for word processors and typewritersThe following settings should be used for written reports. Note that some of these settings are applicable for word processors only. Margins: All margins (left, right, top, and bottom) should be set to one (1) inch. For reports that will either be bound or punched for three ring binders, use a 1.5 inch left hand margin. Line Length or Alignment: Left justify only. Turn off Full Justify or Right Justify for an uneven, or ragged, right margin. This will provide a much more readable document. The only time fully justified paragraphs are necessary is in newletter-type documents with two or more columns of text. Line Spacing: All technical papers should be double spaced (or Line Spacing = 2). Leave one full-size blank line between each line of type on the page. Some word processors use the term leading to specify the line spacing in point sizes. If so, add 2 to the point size and multiply that sum by 2 to get the appropriate value. (Example: for 12 point text, (12 + 2 ) x 2 = 28 points) Hyphenation: As a rule, do not divide words at the end of a line, or hyphenate. If using a word processor, turn the hyphenation function off. Naturally hyphenated words such as self-limiting may break across lines. Page Headers: (Optional) A short, descriptive running head in the upper right hand corner may be used. This header should be physically located approximately 0.5 inches from the top of the page and follow the left and right hand page margins. Page Footers: (Optional) For long reports (typically over five pages), center page numbers on the bottom of each page beginning with second page of text. The footer should be physically located approximately 0.5 inches from the bottom of the page and centered within the margins. Use ordinal numbers (e.g., 1, 2, 3, etc.) for the body of the paper, references, and appendices. Use lower case Roman numerals (e.g., i, ii, iii, iv, etc.) for the abstract's and the table of contents' page numbers . Typefaces [commonly called "Fonts"]Be consistent in your use of typefaces. For short reports, choose only one typeface for use throughout the body of the paper. For longer reports with section headers, you may use one or two typefaces, one for the body text and either a heavier weight (i.e., bold) or a contrasting typeface for the section headers. For most web-browsers, the default proportional typeface is a version of Times Roman). Acceptable typefacesUse a typeface that is similar to one of the three following types: (a) proportionally-spaced, serif typeface [Times Roman or Roman]; (b) proportionally-spaced, sans-serif [Helvetica or Arial]; or (c) monospaced [Courier]. Times Roman or Roman-this is a proportionally spaced typeface found in most "typeset" material such as newspapers and books. This handbook uses a variant of Times Roman for the body text. Each character has an appropriate width (i.e., an i takes up much less space than an M ). The little features found on the ends of each letter (called serifs) tie the characters together into words; this provides a flow to the printed page and makes the words more quickly recognized. Times Roman-style typefaces are very legible; they are the preferred typeface for the body of a paper, especially for long documents. Verify that the printed typeface is suitably supported by the printer you will be using. For laser, ink jet, and 24-pin printers, this typeface should not be a problem. For 9-pin dot matrix printers, a test printing will be required to ensure legibility. Helvetica or Arial-this is a proportionally spaced typeface with a clean, modern look. Each character has an appropriate width (i.e., an i takes up much less space than an M ). As this is a sans-serif typeface, it is a bit harder to read a body of text printed in this typeface than an identically sized one printed in Times Roman. However, because of their large, open look, sans-serif typefaces make excellent figure captions and chapter and section "headers" if a mix of typefaces is allowed in the report. This handbook uses a variant of Helvetica for the chapter and section headers. As with the Times Roman typeface, make sure this kind of typeface will be legible when printed. Courier-This monospaced typeface--found on most standard typewriters--is acceptable for most work. Each character takes up an equal width (i.e., an 'i' has the same width as an 'M'). Courier is an ideal typeface for computer program source code as characters will line up easily. Most printers will print Courier very legibly. In HTML-formatted (Web-published) documents, the mono- spaced typeface is called "preformatted text" and line breaks are hard coded into the document. Because the web browser's automatic word-wrapping capability is turned off with preformatted text, these paragraphs may appear much shorter than all the others on computer displays wider than 640 pixels. It is not a big deal if you understand the limitations. However, if you don't, web-readers will be cursing your inconsiderate oversight as they continually have to use the horizontal scroll bars. You've been warned, don't play cute. Unacceptable TypefacesCompressed Sans-Serif: Do not use any of the compressed or narrow typefaces (e.g., Arial Narrow, Huxley Vertical, etc.); they are very hard to read when used as body text. This is especially true for documents when paragraphs are wide and long. Headline typefaces: Do not use any of the "headline typefaces" (e.g., Bodoni, Umbra, BedRock, etc.) or cute looking typefaces (e.g., Technical, Corsiva, etc.) in a formal report. Such typefaces are either illegible when used in small sizes or hard to read as body text. Consequently, they are never appropriate. Acceptable Typeface Pitches (or Font) SizesWord processors: For body text, set the default text size to either 11 or 12 points; section headers may use point sizes between 11 or 14 point size depending upon the body text. In general, use the default character and word spacing of the word processor. Do not use any text size below 10 points. Typewriters only: Pica (10 characters per inch) Using Different Character WeightsNormal or "middle" weights should be used for text in the body of a document; section headers may use either a normal or bold weight. When required to show emphasis, appropriate use of bold or bold italic character weights is allowed. However, such weights should be used very sparingly to avoid distraction. Underlining vs. ItalicBasically, do not underline text. Prior to the widespread use of word processors, most manuscripts were typed. Accordingly, typists used underlining to indicate type that was to be typeset using italics. As underlined text is harder to read, it is preferable to use italics in the final document if the printer adequately supports italic print. When using a word processor, use either bold or bold italic weights to show emphasis; do not use underlined or italicized text. Symbol TypefacesAppropriate use of symbols is expected, especially in technical reports. Type all the special characters using available system typefaces or special elements. When using a word processor, use either the system's extended character set or the special symbol typefaces. Other special characters and symbols may be found either in an application's documentation or via an operating system utility (e.g., the Windows Character Map application found in the Accessories group). |
|
Tables and FiguresTables and figures should be used when words alone are inadequate to efficiently transmit information. Tables and figures also serve to break up the endless flow of text and add "white space" to a document. This serves to make the document more readable. However, too many inappropriate tables and figures will serve to "clutter" a page and hinder comprehension. When a table or figure will not cover an entire page, place it appropriately at the top, center, or bottom of the page and fill in text above or below as required. Do not break tables or figures across pages unless absolutely necessary. If a table must be broken, make sure subsequent pages include the table's title as well as appropriate row and column headers. TablesTables are typically used to present text or numeric data in a user-friendly, efficient format. However, a well designed table is not easily generated and will require additional effort. Every table should have the following elements:
Additionally, the following elements may be used in any table where appropriate:
For specific information regarding tables, see the appropriate section in the APA Publication Manual. Figures and other graphical imagesFigures are used to present data in a graphical format. The five most familiar forms of figures are graphs, charts, drawings, diagrams, and photographs. Like a table, a well-designed figure is not easily generated and will require additional effort. Remember that poor graphical images may not only distract the reader but may cause more confusion. Graphs and charts are used to more clearly illustrate relationships and trends among data. Each axis of a graph or chart needs to have a well defined label with units clearly specified. Graduated axes should have appropriately spaced "tick marks." Grid lines may be used as desired to enhance readability and understanding. Drawings and diagrams are used to enhance reader visualization of a part or process. Photographs can help with reader visualization if they are in focus and have suitable contrast. If you are preparing a single paper, you can simply secure photographs directly on the page. If, however, the paper is to be reproduced, a halftone image of the photograph needs to be made before it is incorporated into the document. Every figure should have the a figure number (format: Figure 1, Figure 2, etc.) and a brief descriptive title located either above or below individual figures (be consistent!). As in tables, notes can be added to items in a figure delimited using superscripted letters (e.g., a, b, etc.). For specific information regarding figures, see the appropriate section in the APA Publication Manual. |
|
. | Computer Source CodeMany of the students in the College of Applied Science and Technology must write computer programs as a part of their learning experience. Each programming language has its own "style standards" to enhance readability and maintainability. A few of the more common elements of good programming style have been collected below. Obviously, each language, class, and/or instructor will have unique style requirements; use the following as guides unless otherwise noted:
Figure 1: Example of a Commented Header for a C Program Module |
APA-style Citations, Quotes, and List of ReferencesThe Publication Manual of the American Psychological Association is a popular style guide for authors. The faculty of the College of Applied Science and Technology (CAST) has chosen to use the APA format as its default format for citations and references in papers and reports. If you are independently wealthy, the complete manual may be purchased at the university bookstore. If you have Internet access, a summarized version of the APA manual is available on-line at PSYCHOLOGY WITH STYLE: A Hypertext Writing Guide. The three most important sections of the APA sytle guide dealing with citations, quotations, and references follow. Please note that at times, individual CAST instructors may--in the interest of "academic freedom"--require that another style (e.g., Chicago, Campbell's, etc.) be used for their classes. (Typically, it will be the style they used in their dissertation as the terminal degree process burned such stylistic nuances deep into their psyches). If that is the case, then defer to your instructor's wishes, don't argue, and use the specified style. You've been warned. Don't play cute. APA-style CitationsCitations of references in the text should follow the Publication Manual of the American Psychological Association (APA) guidelines. APA publications use the author-date method of citation; that is, the last name of the author and the year of publication are inserted in the text at the appropriate point, with the last name and the date, separated by a comma, in parentheses. For example:
If the name of the author appears as part of the text, for example, only the year of publication is enclosed in the parentheses:
In cases of references with two authors, always use both names:
For works with three to five authors, cite all authors in the first citation; for subsequent references use the first author's surname followed by "et al." For example:
For groups that serve as authors (e.g., corporations, government agencies, etc.) spell out the name in full within the text. For well known names, the name may be spelled out completely for the first citation with the abbreviation in brackets; subsequent citations would use only the abbreviation. For example:
Always use the full name in the Reference List. APA-style Direct QuotationsFor direct quotes, place the name, the date, and the page number of the quotation, each separated by commas, in parentheses:
Direct quotations of less than forty (40) words should be included in the main body of the text without any special formatting other than quotation marks and the citation. For quotations of more than 40 words, indent the quotation (both left and right) approximately 1/2 inch. The APA manual should be consulted for guidance in citing references whenever a question of style or form arises. APA-style List of ReferencesThe reference section contains full citations, listed alphabetically, of all materials referenced in the text. Old style APA references use a "hanging indent" (outdent) format, the latest APA style uses a standard indented format. The following are examples of the most commonly used types of references. Pay careful attention to punctuation and form of these examples. Consult the APA manual (print or on-line) or your instructor for further assistance. Note:
|
|
The DOs and DON'Ts for Written ReportsThe following are some "DO"s and "DON'T"s for good written reports: DO:
Don't:
|
The following is an example checklist that might be used when evaluating student
papers. The student should consider such basic criteria when preparing written
communications.
Note: A single sheet version of this
Written Report Checklist in PDF format
is available for downloading and printing.
Author:
Title:
Reviewer:
Organization (30%): | Poor |
Avg. |
Excellent |
||
The introduction gains the reader's attention and leads smoothly to the thesis. | 1 |
2 |
3 |
4 |
5 |
The introduction includes a satisfactory purpose or thesis statement. | 1 |
2 |
3 |
4 |
5 |
The body is structured and organized appropriately (weighted 2X). | 2 |
4 |
6 |
8 |
10 |
There are adequate transitions between paragraphs and from topic to topic. | 1 |
2 |
3 |
4 |
5 |
There is a definite conclusion and/or action statement. | 1 |
2 |
3 |
4 |
5 |
Content and Sources (35%): | |||||
The subject is appropriate, significant, and is presented in an interesting way (weighted 2X). | 2 |
4 |
6 |
8 |
10 |
There is sufficient supporting material to adequately develop and clarify the subject (2X). | 2 |
4 |
6 |
8 |
10 |
Each sub-topic or paragraph is adequately developed. | 1 |
2 |
3 |
4 |
5 |
Material from sources is smoothly integrated with original commentary. | 1 |
2 |
3 |
4 |
5 |
Sources are appropriately documented. | 1 |
2 |
3 |
4 |
5 |
Grammar & Layout (35%): | |||||
The work is free from errors in spelling (2X). | 2 |
4 |
6 |
8 |
10 |
The work is free from errors in grammar (2X). | 2 |
4 |
6 |
8 |
10 |
The work is free from errors in punctuation. | 1 |
2 |
3 |
4 |
5 |
The paper is neat and orderly with correct margins, typefaces, figures, tables, etc. (2X) | 2 |
4 |
6 |
8 |
10 |
Total score out of a possible 100 points:
Comments:
Last updated on Thursday, Sept. 5, 2019 by Bill Hemphill