views
Planning Your Report
Establish the message you want to convey through the report. You’ve done your research and collected your data, so now it’s time to ask yourself what it all means. How will you define the problem or topic you are addressing, and what conclusions can you draw based on the data and evidence? For instance, you may want to convey the message that a new technique for extracting a particular chemical compound is both safer and more cost-effective. The best technical reports remain clear and focused throughout—they have a specific purpose and convey the information in a logical order. Work with advisors, supervisors, or colleagues to fine-tune the message and/or goal of your report. These can vary widely depending on whether the report is being produced for academic, business, or other purposes.
Define your audience before you begin writing. Who will be reading your report—fellow researchers, corporate executives, the general public, or someone else? It’s imperative that your report is written in such a way that its data and findings can be easily understood by its intended audience. If others in your field will be reading the report, it can be more “technical” in language and detail. In many cases, though, technical reports are intended for those outside of your particular discipline. If so, cut back on the jargon for non-expert readers. Consider having a non-expert friend look over your report throughout the process to give you feedback on its accessibility to a broad audience.
Create an outline to follow while you write. Technical reports are usually very structured, often with clearly-labeled and numbered sections. Therefore, it’s fairly straightforward to draw up an outline that identifies each major element of the report. Determine which particular sections your report must or may have. Consult the person or organization to whom you’ll be submitting the report for any layout requirements.
Writing the Main Body of the Report
Create a thorough but focused introduction to the report. The introduction to a technical report lays out the main problem or issue your paper addresses, and how you go about addressing it in the report. It should indicate to the reader why the issue at hand is important, and clearly establish the objectives for your report. In most cases, the introduction will likely be 1-3 paragraphs in length. The end of the introduction should clearly state what the report “does.” It might do so by way of a direct statement (“This report analyzes…”), or by providing a series of questions (which may in some cases be bulleted or numbered) to be addressed.
Provide background information and/or a literature review in the next section. Right after the intro, delve into the basic circumstances surrounding the topic at hand—a quick history of the problem and its relevance today, for instance. If it has been a topic of sustained debate within your field, you might also walk readers through important examples of past work on the subject. Essentially, you want readers who may be new to the subject matter to feel like they have at least a rudimentary grasp of it after reading this section.
Follow up with a clear and detailed project description. In this section, you basically tell your reader what it is you actually did to tackle the problem or issue at hand. Tell them what type of testing or analysis you did, using what methods and equipment, and any other relevant details. If, for instance, your report is focused on a particular experiment, be specific on the way it was conceived, set up, and conducted. This is sometimes called a “methods” section, since you are describing the methods used to conduct your research.
Present your data and describe what it all means in the next sections. You’ve now reached the heart of a technical report, in which you clearly lay out and contextualize the data you’ve gathered. In most cases, you’ll need to provide numerous figures and tables to present the actual data. Don’t rely exclusively on them, though—use text to put the findings into a context that is appropriate for your intended audience. It can be hard to determine how much data to present. Giving too little can significantly weaken your analysis and the overall report. Giving too much, however, can drown the reader in a sea of tables and figures. Make sure you provide all essential data, and err on the side of providing a bit too much unless otherwise instructed. Present your data in a logical order, so that each table or figure leads into the next one.
Round out the report with a conclusion that bookends your introduction. In a technical report, your introduction should raise the “big” questions and your conclusion should provide your answers. If, for instance, you listed several specific questions in your intro, answer them specifically in the conclusion. Otherwise, use it to pull together your findings into a clear, convincing statement. Be as bold in your conclusions as your data and analysis permits you to be. Don’t use terms like “might,” “perhaps,” “could,” and so forth—write something like, “The data shows that…” However, don’t draw conclusions that aren’t supported by your data.
Adding Components in the Proper Layout
Check for specific guidelines with your university, employer, etc. While there is a fair amount of standardization when it comes to organizing technical reports, the particular layout can vary somewhat by discipline or other factors. The following layout, for instance, is a fairly standard one that might be used in your particular case: Title Page Abstract Executive Summary Table of Contents List of Figures / List of Tables Main Report: Introduction; Background / Literature Review; Project Description; Data / Description of Data; Conclusion Acknowledgements References Appendices
Create a simple title page at the beginning of your report. The title page obviously needs to provide the title of the report and your name, and often includes details like the date and the purpose for the report's submission. Check for any title page layout guidelines for your discipline, department, employer, etc.
Provide a condensed overview of the report in the abstract. The goal of a technical report abstract is to boil down the essentials of the report into about 300 words. You need to provide a very quick rundown of what the report covers and any conclusions or recommendations you make in it. Write the abstract after you’ve written the actual report. You want it to be a condensed description of what you have written, not of what you intend to write. Check to see if there is a specific word limit for your abstract. Even if there isn’t, 300 words is a good word limit to aim for.
Create an executive summary that condenses the report by about 90%. Executive summaries get their name due to the fact that they’re targeted toward high-ranking executives who presumably won’t have time to read the whole report. The executive report should be longer and more detailed than the abstract, but still be only about 10% of the length of the main report. The executive summary should focus on your findings, conclusions, and/or recommendations, and allow the report itself to present the data—although highlights of the data should be provided. Depending on your situation, you may need to write an abstract, an executive summary, or both.
Draw up a table of contents, list of tables, and list of figures. The table of contents should break down the entire report section-by-section, so readers can quickly get a feel for the entire report and find any particular section. Technical reports are data-driven and invariably have many tables and figures, so provide lists of each that quickly identify them and let readers know where to locate them. Check for any formatting guidelines for these sections. If the format is left up to you, keep things simple and straightforward.
Follow the main body of the report with an acknowledgments section. While acknowledgements sections in books or other types of research papers often thank friends and family, in technical reports they typically focus on mentioning those who directly helped facilitate the creation of the report. Basically, any individual or group that supported your work in a professional capacity (including financially, such as through grants) should be acknowledged in this section. This section typically runs 1-2 paragraphs, and follows a fairly simple “The author would like to thank…” format.
Include citations in the references section, using a consistent format. Create a citation for every source you quote from or refer to in the main body of the report. If you are not given a specific citation format to follow (for instance, APA or MLA format), choose one and follow it consistently throughout this section and the entire report. In some cases, you may also be expected to provide a listing of works you have consulted but not specifically cited in the work. Check with the relevant department, organization, individual, etc., if you’re not sure.
Use appendices to provide useful but not essential information. If, for instance, you have a great deal of raw data that isn’t in itself essential to the report, but which is enlightening nevertheless, include it in one or more appendices. Never put anything you consider essential to the report in an appendix—find a place for it in the main body of the work. Use a consistent, easy-to-navigate format when creating appendices. They aren’t meant to be dumping grounds for random snippets of data or information.
Comments
0 comment