Technical Report Elements

25
7/28/2019 Technical Report Elements http://slidepdf.com/reader/full/technical-report-elements 1/25 Elements and Standards Technical Report Writing 

Transcript of Technical Report Elements

Page 1: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 1/25

Elements and Standards 

Techn ical Report 

Wri t ing 

Page 2: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 2/25

Engineers spend a great deal of time

writing technical reports to explain project information to various

audiences.

 Associated Lesson Concept 

Page 3: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 3/25

Many engineers spend between 1/3 and 1/2

of their work time engaged in technical 

wr i t ing . Examples include:

• proposals

• regulations• manuals

• procedures

• requests

• technical reports

• progress reports• emails

• memos 

The Impor tance o f Writ ing 

Page 4: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 4/25

Techn ical Writ ing 

Technical w ri t ing is a type of expository

writing this is used to convey information for technical or business purposes. 

Technical w ri t ing is NOT used to:

• entertain

• create suspense

• invite differing interpretations 

Page 5: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 5/25

Techn ical Reports 

Engineers write technical repo rts (also

calledeng ineer ing repo rts 

) to communicatetechnical information and conclusions about

projects to customers, managers, legal

authority figures, and other engineers.

 A technical repo rt follows a specific layout  

and format as specified by the American

National Standards Institute (ANSI).

Page 6: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 6/25

Fron t Matter 

The f ron t matter  is used to help potential

readers find the report.Once found, the f ron t matter will help the reader 

to quickly decide whether or not the material

contained within the report pertains to what they

are investigating.

Page 7: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 7/25

 

Page 8: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 8/25

1. Cover*

2. Label*3. Title Page

4.  Abstract

5. Table of Contents

6. Lists of Figures and Tables

Fron t Matter 

*May be an optional element 

Page 9: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 9/25

 A cover and label are used

if the report is over 10 pages

long.

The cover (front and back)

provides physical protection

for the printed report. Plasticspiral bindings and thick,

card-stock paper are

recommended.

Fron t Matter: Cover* 

*May be an optional element 

Page 10: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 10/25

Fron t Matter: Label* 

• Report title and subtitle(if a subtitle is

appropriate)

• Author’s name • Publisher* 

• Date of publication

 A label is placed on the cover to identify: 

*May be an optional element 

Page 11: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 11/25

The t i t le page provides

descriptive information that

is used by organizations

that provide access to

information resources (i.e.,

library). A t i t le page duplicates the

information found on the

front cover (if one is used).

Fron t Matter: Tit le Page 

Page 12: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 12/25

 An abstract (informative style) is a short summary

that provides an overview of the purpose , scope ,

and f ind ings contained in the report.

Purpose - identifies the issue, need, or reason for 

the investigation

Scope  - reviews the main points, extent and

limits of the investigation

Findings - includes condensed conclusions and

recommendations 

Fron t Matter: Abstract 

Page 13: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 13/25

• no more than 200 words*

• provides an “in a nut shell”

description without providingunderlying details

• contains no undefined

symbols, abbreviations, or 

acronyms

• makes no reference by

number to any references or 

illustrative material

Fron t Matter: Abstract 

ii

Page 14: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 14/25

The table of con tents  

lists the title and

beginning page

number of each major 

section within the

report (excluding thet i t le page and the

table of con tents ).

Fron t Matter: Table o f Con tents 

iii

Page 15: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 15/25

Front Matter: L ist o f Figu res and 

Tables* 

 A table is an arrangement

of detailed facts or statistics that are

arranged in a row-and-

column format.

The table number and title

appear above the table.

*May be an optional element 

Page 16: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 16/25

The text is the part of a technical report in

which the author describes the methods,assumptions, and procedures; presents

and discusses the results; draws

conclusions, and recommends actions 

based on the results. 

Text 

Page 17: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 17/25

• Summary

• Introduction• Methods, Assumptions, and Procedures

• Results and Discussion

• Conclusions• Recommendations*

• References

Text 

*May be an optional element 

Page 18: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 18/25

•States the problem,

method of investigation,conclusions, and

recommendations

•Contains no new info

that is not contained inthe report

•Does not contain

references

Text: Summary 

1

Page 19: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 19/25

The In t roduct ion  

prepares the reader toread the main body of 

the report.

This page focuses on

the subject , purpose ,and scope of the

report.

Text: In troduct ion 

3

Page 20: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 20/25

Page 21: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 21/25

Text: Recommendat ions * 

 A section called recommendat ions is often

included in reports that are the result of tests and

experiments, field trials, specific design problems,

and feasibility studies.

The author may recommend additional areas of 

study and suggest a course of action, such aspursuing an alternate design approach.

*May be an optional element 

Page 22: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 22/25

Back Matter 

The back matter supplements and clarifies the

body of the report, makes the body easier tounderstand, and shows where additional

information can be found.

Page 23: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 23/25

 Anything that cannot be left out of a report, but is

too large for the main part of the report and would

serve to distract or interrupt the flow belongs in the

appendixes . Examples include:

• Large tables of data

• Flowcharts

• Mathematical analysis

• Large illustrations

• Detailed explanations

and descriptions of testtechniques and

apparatus

• Technical drawings*May be an optional element 

Back Matter : Appendixes* 

Page 24: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 24/25

Back Matter : List o f Symbo ls,

Abb reviations, and 

Acronyms* 

If more than five

symbo ls ,

abbreviat ions , or acronyms are used in

the report, they are to be

listed with their 

explanation.

*May be an optional element 

Page 25: Technical Report Elements

7/28/2019 Technical Report Elements

http://slidepdf.com/reader/full/technical-report-elements 25/25

• Create an outline of your report before you

write it.• Write the body of the report first. Then

write the front and back matter.

• Have someone proofread your report.

Tips for Writ ing