ABE 413 merged. Olumech
ABE 413 merged. Olumech
COMMUNICATION
ABE 413
INTRODUCTION TO AND PRINCIPLES OF
TECHNICAL WRITING
Prof O. U. Dairo
1
Introduction To Technical Writing
❖ Technical Writing
a form of writing that subject matter experts use to clarify, simplify, and
communicate their ideas, often to a tecical or non-technical audience.
A technical report’s purpose is for an engineer to communicate
information gained through a process of technical or experimental work
In the engineering workplace, readers of technical reports include
supervisors assessing progress on specific projects or corporate officers
evaluating professional recommendations and proposals to invest in new
technologies
These non-technical readers might be executives, sales representatives,
end-users, consultants, or virtually anyone else whose skills differ
substantially from the technical writer’s own.
It is divided into sections which allow different readers to access different levels of
information
2
Characteristics of Technical Writing
• Audience Analysis:
Understanding what your audience knows and does not know to help focus your
thoughts and produce documents that add value for others.
Know what questions your targeted audience has about the subject and answer them in
your writing.
Your immediate audience is the professor evaluating your understanding of
theoretical concepts. Other real or imagined audiences include fellow
students, engineering colleagues, or customers seeking engineering services
or products.
3
Characteristics
Simplicity:
No matter how complex the topic is, it’s important to communicate it with
both precision and concision, that is, saying what’s needed but no more.
Avoiding technical jargon is a good practice
The most important information in technical reports is the steps you
followed or the events that occurred
should convey information in an objective, fact-based manner–a style
that ensures technical information and processes that can be relayed
from you to readers in a clear, efficient fashion.
your opinions should not make their way into the text.
The third person, passive voice is required since it allows you to write
with more objectivity and keeps the emphasis of the writing on the
processes you followed and the products you built, rather than on
your experiences or role as a technician.
4
Characteristics
• Modularity:
• When developing material for a knowledge base or other resources that will be used by
different people each topic should receive a single, simplified explanation that can be
reused to develop multiple documents.
• Technical report must follow a stated pattern easily followed by fellow or
un-related personnel
• Typical Report Components
1. Title Page 6. ,Experimental Setup, Experimental
2. Executive Summary/Abstract Procedure,
3. Introduction 7. Sample Calculations,
8. Results and Discussion
4. Theory
9. Conclusion,
5. Apparatus 10. Appendices 5
Components of Technical Report
Title Page
❖ The title should be brief and meaningful and describe the contents
of the report.
❖ The title identifies the subject and indicates the purpose of the study.
❖ includes the title, author’s name, course name and number, lab section
number, instructor’s name, and is not numbered..
6
Components of Technical Report
Executive Summary/Abstract
❖ Typically either an Executive Summary or an Abstract is required with technical
reports, but not both.
❖ The executive summary should give a concise and clear overview of the entire
laboratory experiment or topic to be discussed and should be the main
explanation of the entire.
❖ Readers should be able to gain all necessary information from the Executive
Summary and sometimes will read only this part. It should be written in the third
person, passive voice, and past tense because it explains work already done
A Good Executive Summary/Abstract will Include:
ii. The overall purpose of the experiment or principal objectives.
iii. The problem to be studied.
iv. Experimental methods and materials used.
v. Main results.
vi. Main conclusions
7
Components of Technical Report
Introduction
This section provides a context for the work discussed in the report.
Defines the scientific purpose or objective for the experiment.
Includes a description of the problem and reasons for the work being
done.
Be careful not to use specific technical jargon or abbreviations
Gives sufficient background information to the report.
Must answer the questions:
i. Why was this study performed?
ii. What is the specific purpose of the study?
iii. Justification.
8
Components of Technical Report
Introduction
This section provides a context for the work discussed in the report.
Defines the scientific purpose or objective for the experiment.
Includes a description of the problem and reasons for the work being
done.
Be careful not to use specific technical jargon or abbreviations
Gives sufficient background information to the report.
Must answer the questions:
i. Why was this study performed?
ii. What is the specific purpose of the study?
iii. Justification.
9
Components of Technical Report
Theory
❑ This section is mostly embedded in the introduction, especially if it is
simple and the paper is reporting a specific sub-task like a lab
experiment.
✔ explains the technical background of the work.
✔ includes the mathematical equations, models, and formulae, as well as
the scientific relations in its final forms, which governs the work,
referenced to its original sources
10
Components of Technical Report
DESIGN / THEORETICAL ANALYSIS
❑ Give the details of your design procedure -with sentences plus
formulae
❑ Divide this section into subsections where appropriate
❑ If there is no design but strictly analysis, then provide the important
details of all the analysis performed
❑ Any equations or models should be formatted and numbered
according to the standards followed in technical writing.
11
Materials and Methods
Apparatus/Equipment
• lists all equipment and materials used in the experiment. Be sure to include
identification labels of all equipment.
Experimental Setup
• provides details of the setup needed to carry out the experiment or work. It
could be a circuit diagram, mechanical setup, field rig, equipment setup, etc
Experimental Procedure:
• describes and explains the steps and process of the experiment in
chronological order.
• Must have information in a paragraph structure that allows the reader to
duplicate/repeat the experiment exactly.
• Give the information in a step-by-step format.
• Write mainly in the passive voice.
12
RESULTS AND DISCUSSION
Sample Calculations
• Results are obtained based on equations and mathematical relations which
should have been mentioned earlier in the “Theory” section. If few
calculations are performed, they can be included in this section
Results
• The result should be analyzed, interpreted and stated clearly.
• incorporate labels referenced in the text and fully explain and interprete
Discussions
• results should be followed with a meaningful discussion. The discussion
explains what the results mean and points out trends
• Cite relevamt literature to ack up comformity or otherwise. Discuss errors.
They are acceptable 13
CONCLUSION
❑ Is the final section of the body of the report, the author should briefly bring
everything together
i. Must answer any questions raised in the introduction regarding what was shown, discovered, verified, proved, or
disproved.
ii. Must explain why the experiment is significant.
iii. Must explain the implications for your particular field of study.
iv. Should not include discussion of new information not already mentioned in the report
❑ Useful information too lengthy to fit within the body placed in an appendix.
16
ABE 413
(TECHNICAL WRITING & PRESENTATION)
Prepared by:
Dr. A. Sobowale
Department of Agricultural and Bioresources Engineering
Fed. University of Agriculture, Abeokuta, Nigeria.
GENERAL INTRODUCTION
The art of technical writing requires knowledge of some
important terminologies. These terms are paramount in the
dissemination or propagation of technical knowledge.
A. Information
This generally refers to a body of knowledge gained from experience, observation
and/or investigation. This knowledge is organized and presented in a form
understandable to anyone who comes in contact with it.
B Technical
A piece of information or subject matter is said to be technical if it is peculiar to
or characteristic of a particular art, science, trade or profession. For example,
the term “Factor of safety” is a technical term in engineering design peculiar to
the field of engineering.
C Reporting
This can be defined as providing an account for or describing what has been
learned by experience, observation and/or investigation. Examples are: police
2
report, audit report, technical report, financial report etc.
When the above terminologies are grouped together, it provides a good
picture of the main thrust of this course, which is “the art of
reporting technical information”.
The problem or subject matter that is not popular knowledge but rather is
specialized in that it belongs to art, science, medicine, engineering or the likes.
It also involves organizing and presenting the information thus gained so that it
may be clear and meaningful to the person or persons for whom it is intended
3
Characteristics of A Good Writer
a. The person must be reasonably methodical and painstaking
b. He or she must be very objective
c. The writer must record what he/she has done and learned
d. There must be clarity in writing.
e. A good writer must as a matter of importance learn how to write.
Stage II: - This contains more specific statements about the aspect of the problem already
studied by other researchers.
State III: - This stage contains statements that indicate the need for more investigation in
the field of research being reported on.
State IV: - Contains very specific statement giving the purpose or objective of the study.
State V: The section should give a value or justification for carrying out the study
6
(Statement of value)
Stage I (The setting)
The setting should begin with accepted statements or facts related to a general area. Within the
general area, identify one sub-area, which include your topic. Finally introduce your topic.
(a) It continues the process started in stage I of giving readers the necessary background information
needed to be understood in your study.
(b) It assures your readers that you are familiar with important research that has been carried out in
your area of study.
(c) It establishes your study as one link in a chain of research that is developing and enlarging
knowledge in your field.
Citation Focus
When you cite authors, you may choose to focus either on the information provided by that author or
the author himself or herself.
The first focus is called information prominent. This is because the information is given primary
importance. The author’s name(s) and date of publication is attached at the end of the statement.
8
Most complete source of information is found in an alphabetical list of references at the end of the
paper.
The second type of citation is the Author Prominent, where, the
author’s name(s) serves as the subject matter, followed by the date
and then by the information.
Order of citation
(1) Citation group by approach:-
This is done by citing the references one after the other, E.g. “Dester (1980) proved
that dissolved oxygen concentration affect the growth rate of the cat fish, Emeka
(1985) also showed that dissolved oxygen concentration is affected by stream
temperatures”. 11
(2) Chronological citation: - This is when citation is made in an order showing the
year of publication from distant to close. E.g
“(Adams,(1980); Exon, (1983); Ade,(1989); Omale,(1993)”.
13
Stage III (missing information)
The purpose of this Stage is to signal to the reader that the literature review is
finished.
It sums up the review by pointing out a gap i.e. an important research area,
which is not yet investigated by other authors.
Usually, Stage III is accomplished in only one or two sentences. There are three
alternatives you can choose from in writing stage III statements.
(1) You will indicate that the previous literatures described in stage II is inadequate
because an important aspect of the research area has been ignored by other
authors.
(2) You will indicate that there is an unresolved conflict among authors of previous
reports concerning the research topic. This may be a theoretical or
methodological disagreement.
(3) You may indicate that an examination of the previous literatures suggests an
extension of a topic or raises a new research question not previously considered
by other workers in your field
In indicating some kind of gap left by earlier studies, stage III prepares the
reader for your own studies. 14
Examples:
(1) However, few studies have been reported on ……the effect of female genital
mutilation.
(2) “But, little information is available on the performance evaluation of cocoa
bean extractor.
15
16
Stage V (Statement of Value)
This is the stage where justification is given to the research work.
Justification is made on the basis of some possible value or benefits. This
stage is not included in every introduction, only when you write a thesis,
dissertations or thesis proposal.
Sometimes when funding for the research is sourced from a body or
government, it is necessary to include statement of value. In reports written
up as journal articles, stage V is often omitted.
Examples: -
(1) This work may provide an alternative to the use of firewood for cooking.
(2) The results of this study could be useful in irrigation scheduling.
17
RESEARCH METHODOLOGY
This section of the report deals with describing all the Logical and Scientific steps
taken to achieve the objectives of the research work. It may include the
following: -
(a) Experimental design
(b) Sampling techniques and Instrumentation
(c) Data collection and handling
(d) Data Analysis and tools employed.
In the case of engineering design, all the component parts of the structure or
machine are designed for with relevant calculations and drawings included in this
section. It is very essential to give a brief description of the rudiments of the above
since it is important for report writers to understand them.
Experimental design
This entails the identification of the elements of your study, demarcating them into
various treatments in order to bring about the comparison of the various treatments
e.g. “performance of maize under different water regimes”, another example is the
“tensile strength of mild steel with different carbon content”, This section
18 gives a
picture of the variables considered in the study.
Sampling Techniques
This section tells the readers the method adopted in the selection of your
variables e.g. Random-sampling; quota sampling; systematic-sampling; stratified-
sampling etc.
It is also essential that you tell your readers the types of instruments used to
collect your data. For example
1. “The speedy moisture tester was used to determine in-situ moisture
content” (Sobowale, et. al., 2003)
2. “Brinnell’s hardness tester was used to determine the hardness of the
material”.
Data collection and handling
In studies that require interviews to get information, questionnaires are often
used. Questionnaires refer to a list of questions given to respondents to fill in
order to get their opinion about the questions being asked. This is more useful
in social and economic studies.
Some studies require the collection of relevant data from agencies for analysis.
Some of these data must be processed, sorted and documented on a database.
Some data are collected by direct measurements of the variables over a period
19
Language Convention
Most of the time, the writing of the materials and methods section of a report
involve the use of active or passive voice to describe the procedure used in
the project or study.
Examples of these voices can be found in experimental research reports. The
22
formation of active and passive words requires the verb auxiliary plus past
participle of a verb.
Example of Active Voice: –
“We applied stress to the rubber segments in gradually increasing manner”.
Example of Passive Voice: -
“Stress was applied to the rubber segments..”
Your decision to use the active or passive voice in procedural statements should be
made with the following consideration: -
(A) The passive voice is conventionally used to describe procedures in order to
depersonalize the information. The passive voice construction allows you to omit the
agents, usually “I” or “we”, placing the emphasis on the procedure and how it was
done.
For example: -
“The data were collected and were analyzed”
Sometimes Shortened Compound sentences are used.
For example: -
(I) The data were collected and correlations were calculated (Active)
(II) The data were collected and correlation calculated (passive)
23
(III) The data, which were obtained, were subjected to an analysis of variance (Active)
(IV) The data obtained were subjected to analysis of variance (Passive)
RESULTS AND DISCUSSIONS
This section of the report is meant to present the findings of your study and to
discuss them.
The writer is expected to present the important findings of the study in both
figures and written texts.
The figures (graphs and diagrams) and tables present the complete findings in
numerical terms while the accompanying text helps the readers to focus on the
most important aspects of the result and to interprete them.
For the purpose of thesis or dissertation, the result and discussions are usually
extensive.
But for the purpose of paper for publication in journals etc., the section is
usually brief presenting only the important findings. This is due to the
limitation of space available in the journals.
There seems to Resultsbe no written precedence on how to arrange the results
and the ensuing discussion, but, experience has shown that in most research
reports and thesis, there appears to be the recognition of a logical flow of
work.
Results of analysis relating to the same objectives should be tied together.
24
In some cases, elements (i) and (ii) can be combined. The present tense is often
used to locate figures e.g.
–“Results of the pumping tests are presented in Table 1.0”
- “Table 4.2 summarizes the results of the analysis of variance of the data on
Dry density of the samples”
- “Figures 3.2 show the relationship between traffic density and travel time of
buses along Abuja – Lokoja highway.
When reporting the findings of your study, it is important to note that “past
tense” should be used in the reporting. For example,
-“The coefficient of correlation was found to be significant at the 0.00l25level”.
When commenting on the findings, which compare your results with other
studies, the writer should use the present tense.
For example -
-“This result is consistent with earlier findings suggesting that there is an
inverse relationship between the two variables”
When making comments, which generalize from the result, the writer should
use the word “May” e.g.
-“Irrigating sorghum at reproductive stage may reduce yield”
In giving element (iii) comments, the writer can also use tentative verbs in the
present tense instead of modal auxiliary to generalize your results e.g.
27
(3) Finally, the findings may show the relationship of one variable with another or
among variables. When reporting this kind of result, it is common to use verbs.
E.g. Correlation and association.
28
Part for
TECHNICAL Adeosun
REPORT WRITING
• What is Communication
• Importance of Engineering
Communications
• Technical Writing and Reporting
• Types of Technical Reports
Module One
• Introduction
• An overview of the Course Outline to demonstrate what is expected
of the students to know in this course is undertaken. This will
include def in itions of relevant terminologies and introductory
aspects of the core areas like presentation of reports in writing,
orally as in seminars or symposia. An engineer should be able to tell
people of different callings or cadres what he or she is doing in
forms of reports. At least f iv e different types of reports shall be
discussed in view of the different assignments in which the
engineer is involved.
What is Communication?
• References
Types of reports
• SECTIONAL DISCUSSION
MODULE 3: COMPONENTS / STRUCTURE OF
A TECHNICAL REPORT
• Declaration / Certification:
This is also optional.
It shows that the material in the report is the
author’s own work.
• Table of Contents:
– It is the list of what is in the report.
– Major sections of the report must be listed with page
numbers.
– Second and third level headings may also be listed in
the table of contents.
– It is done when everything about the report is in place
and then paginated accordingly.
• Lists of Figures, Tables and Plates:
– The list of figures contains the listing of all the figures
[drawings and graphs] in the report.
– They are listed in consecutive order that they appear
in the report with caption and page number.
– Lists of tables and plates are similar to the list of
figures, but for all the tables and plates that appear in
the report.
– In the text, the caption of a table is placed on top,
while those of figures and plates are placed below
• List of Symbols:
– This is used for a report that contains a lot of
formulae and symbols.
– The list is however optional although it makes
for better reading and understanding when a
list explaining the symbols is included.
• Acknowledgements:
– It is the usual practice to give credit to those
who in one way or the other contributed to the
success of the work being reported.
– S uc h c o nt ri b ut i o n c o ul d b e i n f o rm o f
provision of funds or material for the work,
loan of equipment, discussions about the
work, computations and even typing of the
report.
SECTIONAL DISCUSSION
MODULE 4: COMPONENTS/STRUCTURE OF A
TECHNICAL REPORT [Continued]
• Introduction:
– It provides insights into the problems the work is being designed
to solve or answer and how to go about it.
– The statement of objectives an important function of this
section is also made.
– This section also provides the justification for the investigation /
experimentation.
– A brief and relevant historical review of the problem is made.
– Some reports have separate section for Technical Background.
– The necessary concepts for the work are explained.
– The technical level and ability of the would-be readers of the
report is taken into consideration.
• Experimental Details
The work itself is reported here usually under the
following subheadings:
– Materials and Methods.
– Design Calculations.
– Choice / Selection of Materials.
– Drawings.
• SECTIONAL DISCUSSION.
MODULE 5: WHAT NEEDS ARE NECESSARY
FOR A TECHNICAL REPORT?
a) Understanding the Subject Matter:
– The author must understand the subject matter very
clearly and without any doubting mind.
– He must ask and attempt to provide answers to
certain questions such as ‘why am I writing?’ and
‘what am I trying to achieve?’
– Ability to be able to provide answers to these
questions and many others leads to the
understanding of the project to be undertaken.
– The AIM of the work has to be def ined and this will
lead to def in ing the procedures to adopt for the
implementation.
– Evaluation of all information, arguments and
recommendations against that aim will then have
to be made.
– Thus setting down the aim must be the f irst step
in any piece of writing.
– Then the thoughts can now be focused until a
clear idea of the answers to the questions ‘why
am I writing?’ and ‘what am I trying to achieve?’ is
obtained.
– If there is more than one aim, then they should be
sorted into priority order.
b) Planning of the Work:
– There is need for adequate planning and execution
of the plan.
– The plan is about getting materials for the write-up.
– This implies that the experiment has to be well
conceived, well designed, monitored and supervised.
– There should be NO LAPSES in both design and
execution.
– Lapses in project implementation often yield fatal
results.
– For example, in a building construction with certified
design, if supervision is not properly done, there
could be a structural failure arising from not using
t he re c o mme nd e d mat e ri al s by t he bui l d i ng
contractors.
– The gravity of this failure can be imagined for three
or more storey buildings!
c) Data Collection and Analysis:
– Data for the write-up should be carefully collected.
– Analysis should be carried out using appropriate
statistical tools where necessary.
– It is very important that this step must be taken with
all seriousness.
– Interpretation of the result of analysis for wrongly
taken data would only give bad report.
– This also dangerously leads to misinformation.
– The crucial part of the report is obtained from the
analysis of the data collected.
• SECTIONAL DISCUSSION.
MODULE 6: WHO NEEDS A TECHNICAL
REPORT?
• The engineer needs to communicate:
– Engineers are problem solvers, but they are not
normally the implementers of their solutions.
– To be effective problem solver, an engineer's solution
must be communicated to policy and decision makers.
– Also to those who must implement the solution.
– E ngine e rs o fte n f in d the mse lv e s within a large
organizational structure, such as a design f ir m with
several layers of decision-making management.
– As one moves up through the layers, the managers
have less and less understanding of the technical
details and less and less time for reading reports.
– Thus, i t i s v i t a l l y i m po r t a nt fo r e ngi ne e r s t o
communicate effectively.
– Engineers spend on average 2/5 of their time in
communication, i.e., they spend 2 days out of 5
communicating to peers, superiors, laymen, the public,
etc.
– "An engineer who cannot communicate is in trouble"
– "If you cannot tell them what you are doing, they will
hire someone else who can."
– The primary means of communication in large
organizations are technical reports, which have
several vital organizational functions:
– communication of technical information to others
within the organization who need the information to
carry out their jobs;
– communication of the activities of a company to
outside observers;
– communication of the activities of one division to
another division within the same company; (Other
divisions are often considered relative outsiders); and
– communication to colleagues and superiors about
what and why an activity is being done.
• SECTIONAL DISCUSSION.
MODULE 7: HOW THEN IS A TECHNICAL
REPORT WRITTEN?
• Presentation:
• With technical writing, information must be presented so
that readers can:
– use the repor t for the purpose for which it was
requested;
– extract the main points without necessarily reading
the whole report;
– easily find the information that interests them; and
– quickly absorb the crucial information they need to
know.
• Documents have to be well organized otherwise readers
may miss important information.
• It is up to the author to present his / her information in a
readable and well-organized way.
• Offer informative summaries, clear instructions and a
logical arrangement to let readers pick and choose the
parts they want to read.
• So it is a good idea to write down the sections and
subsections needed to plan the document.
• This helps the author think about his / her aim and
readers’ needs, drop unnecessary information, stress
important information and so on.
• I n presenting the repor t therefore, the following
presentation guidelines are recommended:
– Script – the report must be printed single sided
preferably on white A4 paper. Hand written or dot-
matrix printed reports are not acceptable.
– Margins – all the four margins [top, bottom, right and
left sides] must be at least 2.54 cm.
– Page Numbers – do not number the title, summary or
content pages; number all other pages consecutively
starting at 1.
– Binding – a single staple in the top left corner or three
spaced down the left hand margin for the draft; for
final report, binders should be used.
– Diagrams – should be simply drawn specif ic ally for
the report; put small diagrams after the text reference
and as close as possible to it.
– SECTIONAL DISCUSSION.
MODULE 8: HOW THEN IS A TECHNICAL
REPORT WRITTEN? [Contd]
• Graphs – graph should follow after text reference
similarly to the diagrams.
• Tables – dependent tables [small] could be placed within
the text even as part of a sentence;
– independent tables [large] are separated from the text
with table numbers and captions;
– They are positioned as close as possible to the text
reference;
– larger and complicated tables should be placed in the
appendix.
• Mathematics:
– use mathematics only where it is the most eff ic ient
way to convey the information;
– longer mathematical arguments should go into the
appendix.
• Equations:
– like mathematics use equations in a technical report
where possible!
– Number all equations consecutively.
– All notations used should be clearly defined.
– Avoid using the same mnemonic for two different
variables!
– Equations should be centered on the page with
e q uat i o n numbe r o n t he si d e fo l l o we d by t he
explanation of the symbols. For example:
• Q = AKR2/3 i½ (1)
Where, Q = flow rate in m3/sec
A = channel cross sectional area in m2
K = roughness coefficient
R = hydraulic radius in m, and
i = longitudinal slope
M O D U LE 9 : OT H ER M I S C ELLA N EO U S
DESCRIPTIONS ON PRESENTATION
• Headings:
– major or f ir st level headings should start on a new
page just as a new chapter starts on a new page.
• Font Type and Size:
– the 12 point serif typeface such as Times New
Roman is standard for report writing.
– Keep colour usage to a minimum.
– Black or black gray-scale figures are adequate.
– Avoid using fancy fonts.
– Avoid using capital letters in the body of the report,
instead fonts can be bolden or italicized.
• Contractions and Abbreviations:
– not used in formal writing not even technical writing!
e.g. use “it is not possible” instead of “it’s not possible”
or “this equation will not work out well” instead of “this
equation won’t work out well”.
• Abbreviations should be sparingly used.
e.g. use “Figure 23” instead of “Fig 23” or “Table 45”
instead of “Tab 45”.
• Acronyms:
The full name should be written out with the acronym in
parenthesis the first time the name appears in the report;
then use the acronym in subsequent occurrences.
Use the ten to twenty most common and understood
acronyms in your organization without explanation when
writing internally.
Write full form and the shortened word form when
writing to other audiences or to the public.
• Third person narrative – write all formal reports in third
person narrative and avoid personalized writing.
e.g. “it was decided that equation 7 should be used”
rather than “we decided that equation 7 should be used”
or “maize seeds were planted in a spacing of 30 cm x 75
cm” instead of “I planted maize seeds in a spacing of 30
cm x 75 cm”.
• Use diagrams, flowcharts and graphs:
The cliché a picture is worth a thousand words is true. A
go o d d i a gr a m , f lo w c h a r t o r gr a ph c a n pr e se nt
information quickly that would take ten sentences to
explain.
See a diagram below showing a car's clutch. Such a
diagram makes any explanation or technical description
far easier to understand.
• Keep technical terms to a minimum:
– Use technical words reasonably.
– e.g. in a desktop publishing manual one could use the
terms folio, recto and verso. The simpler page or page
number (folio), right-hand page (recto) and left-hand
page (verso) are easier for the reader to follow.
– Use examples and illustrations:
• write up technical information, using examples,
illustrations and analogies to explain d iff ic ult
information or new ideas. e.g.
– The crawler tractor is as fast as a cruising snail, no
wonder you were unable to plough the specif ied area
intended for the farm.
– A simple example or illustration can go a long way to
making technical writing understandable.
– SECTIONAL DISCUSSION.
MODULE 10: CONCLUDING PARTS
• Breakdown of Report into Sections
– Once the major sections and subsections have been
def ined, each section should be written going from
the general to the particular.
– Each section begins with a general description of the
greater detail to come at the end of the section.
– This way, the selective reading habits of the target
audience is enhanced.
– Some sections may be only of general interest to
certain people.
– Such may only want to read the f irst paragraph to get
an overview of the section's information content.
– The general part of a section may be as short as one
sentence that serves to summarize the information
content of the section.
– For larger sections, it may be several paragraphs.
• Finalizing the Report and Proofreading
– In the f inal stages, the author should ensure that the
introduction is intact.
– Main text in sections, conclusions, all properly
formatted.
– References and bibliography and any appendices are
all okay.
– Page numbers, contents and title pages will now be
added.
– Then the summary or abstract is written.
– The summary with the title should indicate the scope
o f t h e r e po r t a n d gi v e t h e m a i n r e s u l t s a n d
conclusions.
– It must be intelligible without the rest of the report.
– Many people may read and refer to a report summary
but only a few may read the full report, as it often
happens in professional organizations.
• Proofreading:
• This is checking of every aspect of a piece of written
work from the content to the layout.
• It is an absolutely necessary par t to the writing
process.
– Every scientist and engineer should cultivate the habit
of never sending or submitting any piece of written
work without at least one and preferably several
processes of proofreading.
– Let someone else who could be your colleague or
superior off ic er help you to read carefully and check
for errors in content, style, structure and layout.
– Such person or persons should be acknowledged in
the report.
• CONCLUSION
– A technical report is a formal report designed to
convey technical information in a clear and easily
accessible format.
– Good writing, whether technical or general, presents
relevant information in a clear style.
– In certain instances, technical writing has such a poor
reputation.
• For example, ask users what they think of computer
manuals.
• Many writers often fail to use the clear, plain English
style.
• P lain E nglish is a simple style that anyo ne c an
understand.
• Writers are encouraged to control sentence length, use
active verbs, cut down on unnecessary jargon, and
make their writing specific and tight.
– The culture of academic writing and business and
scientif ic writing is the dull, long-winded, passive
style.
– M any w r it e r s hav e d iff ic ult y ke e p ing t he ir
messages simple and clear. Instead of using
everyday words they use complex or unfamiliar
words.
– Simple everyday words will get message across
to the would-be readers.
– Too often, technical writers use words such as
additional, indicate, initiate and proliferate instead
of the simpler extra, show, start and spread.
• SECTIONAL DISCUSSION.