Implementation Technical Paper 3 - Phase 1 Data Elements ...
Technical Report Elements
-
Upload
jayamathiv7987 -
Category
Documents
-
view
221 -
download
0
Transcript of 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
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
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
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
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).
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.
7/28/2019 Technical Report Elements
http://slidepdf.com/reader/full/technical-report-elements 7/25
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
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
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
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
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
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
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
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
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
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
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
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
7/28/2019 Technical Report Elements
http://slidepdf.com/reader/full/technical-report-elements 20/25
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
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.
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*
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
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