Upload
luke-black
View
222
Download
2
Tags:
Embed Size (px)
Citation preview
Technical Report Writing
Technical Report Writing Day 2
Objectives:
Introduction
Literature review
Objectives of the report (Note: the words objectives, aims and purpose are synonyms)
Body
Introduction-length
Your introduction – 250 to 500 words
The introduction includes
the background to the topic of your report (this is to set your work in its broad context)
a clear statement of the objective of the report.
technical background necessary to understand the report; e.g. theory or assumptions
Background information
How to write the background informationSelect factual information pertaining to the
subject.Chronology of how product problem evolved
to the current situationWrite in an objective manner.
What questions should introduction answer?
What is the problem?Why is it interesting and important?Why is it challenging? (E.g., why do
conventional approaches fail?)Why hasn't it been solved before? (Or,
what's wrong with previous proposed solutions? How does mine differ?)
What are the key components of my approach
Sample Introduction – focus on the points not the length
(background info) The Avaya MDW 9012 wireless pocket phone is a light weight, pocket sized pocket phone. It lets you make, receive announce and transfer call while having the freedom to move around freely. (problem) This guide will cover ( 1.) understanding the handset display icons (2.) Using the handset for making calls (3.) changing the setting. This guide will not cover the conference call using the hold button.(solution) To use this guide the front desk staff should be familiar with the basics of using multi-line phones and transferring calls.
Activity: Select the best introduction
OPTION A:
The objective of this project is to introduce our group's two conceptual designs. We have included the following sketches for each car: 3 dimensional view, elevation, plan, front, rear and interior view. Also, we have included a discussion of how the designs meet the criteria given in the project outline. The cars could be suitable for short trips in busy areas.
Activity: Select the best introduction
OPTION B:With the rise in global warming and increasing pollution levels, it is becoming essential to find a viable alternative to the internal combustion engine petrol powered car. The aim of this project was to create two designs for a fuel cell powered car, the main criteria being environmental friendliness in terms of both emissions and materials.This report presents the designs for two such cars, each of which includes the following components: engine, fuel, wheels, accessories, safety features and materials. Car A is aimed at the upper end of the market, while Car B is a mid-range vehicle suitable for family use.A description of the design and an analysis of operational efficiency for each car are followed by a comparison of the two designs. Finally, the most cost efficient design is recommended.
Activity
Read the report and write the introduction
Grammar: Avoiding Verbosity
The fact of using more words than needed is called verbosity. While writing the introduction make sure that your sentences do not have unnecessary words.
Activity: Avoiding verbosity (avoid wordiness)
1. The theme of this year’s summit is ‘From Essential Elements to Effective Practice,’ and the conference will include a variety of interactive sessions.
2. John Smith runs the DJ Project, an after-school program in San Francisco for students struggling in school. He uses hip-hop to connect with the students.
3. It’s rather annoying that you can’t turn off the various sounds that play when you use the zoom and other functions.
Activity: Literature Review
What to include in literature review?
Literature Review
In your literature review, you show how your research builds on prior knowledge by presenting and evaluating what is already known about your research problem.
Why conduct a literature review?
Helping the researcher understand the existing body of knowledge
Providing a solid theoretical foundation for the proposed study
Substantiating the presence of the research problem
Justifying the proposed study as one that contributes something new.
Framing the valid research methodologies, approach, goals, and research questions.
Functions of literature review
To justify your choice of research question, theoretical or conceptual framework, and method;
To establish the importance of the topic;
To provide background information needed to understand the study;
Functions of Literature Review
To show readers you are familiar with significant and/or up-to-date research relevant to the topic;
To establish your study as one link in a chain of research that is developing knowledge in your field.
Goal of introduction and literature review
The goal of the introduction and literature review is to demonstrate the logical continuity between previous and present work. The reader should understand why the problem was researched and why the study represents a contribution to existing knowledge
Activity: Write a literature review
From the report provided, write a literature review in your own words. Include the following:
Background of the research problem
Findings of the work
Establishing your point
Method
The method section includes separate descriptions of the sample, the materials and the procedures.
Describe your sample with sufficient detail so that it is clear what population(s) the samples represents. Outline and document clearly why and how the sample was formed in your study.
Method
You should also describe your instruments, including all surveys, tests, questionnaires, interview forms, and other tools used to provide data.
Make sure you provide or mention the reliability and validity on data collection.
Grammar: Verbs
Verbs to use for the background information:Use appropriate tenses, depending on the situation you are describing:
Eg: how a machine operates or describing an;
existing situation –Present Tense;
detailing history –Past Tense
Activity: Verbs
Lars: Excuse me, which movie are you waiting for?
Tony: We (wait) ________ for the new Stars Wars movie. In fact, we (wait) _______ here for more than five hours. Lars: Five hours? When did you arrive? Tony: We (get)_____ here at 6:00 o'clock this morning. More than forty people (stand, already)_______ here waiting for tickets when we arrived.
Activity: Verbs
Lars: When did you buy your tickets?
Tony: I (buy) _____ hem last week by phone. I (know)_____ tickets would be hard to get because I (see) _____ a news interview with a group of people standing in line to get tickets. They (wait) ______ in line for almost a month to buy tickets for the first showing.
Lars: I don't believe that!
Objective/purpose/aim of the report
What do you understand by the term objective/purpose/ aim?
Objectives of the report
The objective is the starting point for the whole investigation. The purpose/aim/objective is what the writer proposes to write about and what he hopes to achieve through the writing.
Purpose/objective/aim
Example:
This article will examine the knowledge andattitudes of consumers who buy branded products.The purpose of the article is to examine….
Purpose/objective/aim
Another example:
Eg: This paper discusses the underlying problemsassociated with Process A and aims to find a viable solution to the situation.
Example of objectives in a report
1. To research optimum temperature and humidity for the working environment;
2. To measure current temperature and humidity in Factory D.
3. To determine whether optimizing conditions will result in enhanced Productivity.
Objectives in a report
Ways to write the objectives: 1. The objective of the investigation was to… 2. The experiment was carried out in order to investigate… 3. The goal of this study was to… 4. In this study we investigated whether…
Verbs used for objectives
To inform To explainTo presentTo highlightTo summarizeTo give an account ofTo give an overview ofTo direct the readers attention to
Activity: Objective of a report
From the handouts provided , write the objectives of the report in your own words.
Body of the report
This is main part of the report, where you present your work. The introduction and conclusions act as a frame for the body only: therefore all the details of your work must be included here in the appropriate section.
You will need to put some thought into the ordering of the sections; the presentation of information should flow logically so that the reader can follow the development of your project.
It is also essential that you choose concise but informative headings and subheadings so that the reader knows exactly what type of information to expect in each section.
Body of the report
Presents the information from your research, both real world and theoretical
Organizes information logically under appropriate headings
Conveys information in the most effective way for communication:uses figures and tablescan use bulleted or numbered listscan use formatting to break up large slabs of text
Headings
Headings are of four kinds:
Informative headings
Uninformative headings
Consistent headings
Inconsistent headings
Headings
Informative headings Must ne specific and content focused. They must give some information about the work.
Example are:
Overview of the organizationCommunication in the organizationGroups in the organizationManagement style and methods
Headings
Uninformative headings: Some headings do not give clear idea of what is written in the body paragraphs.
Example are:
The organizationThe managementThe groups
Headings
Consistent headings: This is the most commonly used format for section headings in an informational report.
Example: Company structureCommunication channelsGroup participationDevelopment of effective management skills
Headings
Inconsistent headings: When we say inconsistent it means that the headings have no common grammatical forms. That is why they are inconsistent.
Example:The company structure ( Noun
phrase)Do the communication channels work?
( Question)Participation in groups (Gerund
phrase)
Which of the following section headings are grammatically consistent?
Activity: Which headings are grammatically consistent?
Option 1: Car AThe Materials we selected
Emissions How the safety features Work What Accessories are included?
Option B: Car A Materials selection Emissions Safety features AccessoriesOption C: Car A The Materials Selected Emissions Safety features of the car Accessories included
Answer
Option 2 is the right answer.
Reason : There are no unnecessary use of words, the points are short and focused. Words like “the” and question words like what and how are not there.
Common grammatical errors
Use the active voice to make your
writing more direct and vigorous.
Avoid big words.
Activity: Change from passive to active
1. Control of the bearing-oil supply is provided by the Shutoff valve.
2. Leaking of the seals is prevented by the use of O-rings.
3. Fuel-cost savings were realized through the installation of thermal insulation.
Answers
Shutoff valves control the bearing-oil supply.
O-rings keep the seals from leaking.
The installation of thermal insulation cut fuel cost.
Activity: Avoid big words
Change the big words into simple words:
Terminate: _________________Utilize : ________________Incombustible: ________________Substantiate: ________________Eliminate: _________________
Answer: Avoid big words
1. End2. Use3. Fireproof4. Prove5. Get rid of
Figures, tables and equations
Usually only these two categories are used while writing reports anything other than tables (maps, charts, diagrams, drawings, graphs) is called a figure.
Figures and tables should be placed as close as possible to the point at which they are referred to in the text
Figures, tables and equations
Give all figures and tables a number and title.
Refer to each figure and table in the text of the report.
The title of a table goes above the table
The title of a figure goes below the figure.
Figures, tables and equations
Give all figures and tables a number and title.
Example :
Table 1 Existing communication channels
Write the tale number first followed by the title of the table.
Figures, tables and equations
Refer to each figure and table in the text of the report.
Example:
The communication channels in the organization are shown in Table 1.
The title first and the table number later.
Figures, tables and equations
The title of the table goes above the table:Table 1 Turning volume of pedal cycle
(1) (2) (3) (4) (5) (6)
8:00 - 8:15am 0 0 1 0 1 0
8:15 - 8:30am 0 0 1 1 0 0
8:30 - 8:45am 0 0 3 1 0 0
8:45 - 9:00am 0 0 2 3 1 0
Total Volume 0 0 7 5 2 0
Figures, tables and equations
Example of a figure:
Figure 1: Phase shift keying modulation
Figures, tables and equations
Equations: The conventional style for presenting equations is as follows:Centre the equation on the pagePlace the equation number in round
brackets at the right-hand marginIn the text of your report, refer to the
equations as either Eq. (1) or equation (1). Use whichever format you choose consistently throughout your report.
Figures, tables and equations
Equations:
The relationship of the speed of propagation and the volumetric tissue fraction is given by: