Unit I - Introduction To Technical Writing
Unit I - Introduction To Technical Writing
GENERAL OBJECTIVES:
At the end of the course, the student is expected to:
1. know the nature, properties of the different kinds of technical literature
2. know the basic techniques and apply the same in the preparing a
technical report
3. gain proficiency in writing business letters as tools in business
transactions to obtain good will and secure favourable responses
4. appreciate the importance of preparing technical reports and business
correspondence
5. conduct research studies after knowing the nature, types, &
methodologies of research.
COURSE OUTLINE
1.
2.
3.
4.
UNIT I - INTRODUCTION
DEFINITION & NATURE OF TECHNICAL WRITING
PROPERTIES OF TECHNICAL WRITING
KINDS OF TECHNICAL LITERATURE
OPINIONS OF WELL-KNOWN ENGINEERS AND SCIENTISTS
UNIT II BASIC TECHNIQUES OF TECHNICAL WRITING
1.
2.
3.
4.
5.
DEFINITION
CLASSIFICATION
PARTITION
DESCRIPTION OF MECHANISM
DESCRIPTIONOF A PROCESS
1.
2.
3.
4.
5.
6.
MID-TERM EXAMINATION
1.
2.
3.
4.
5.
UNIT I - INTRODUCTION
IMPORTANCE OF TECHNICAL WRITING
We live in a technical world today. Our home and our office, marketplace or
playground, as short or long journey all depend on technicalities. A slight lapse
may lead to tragedy. Remember Selendra 2 tragedy in Makati where police
concluded as Gas explosion. All result of human failure. The failure in most of the
cases was because of our lack of ability to exercise the technicalities in clear
language.
We live in a dynamic world. The ways and methods of expressions keep on changing
at a rapid pace. Success in todays world is commensurate with the familiarity of
using technical gadgets in the most efficient manner. Modern day professionals,
apart from working for his organization, collects information, gathers data,
compares, analyses them, and prepares reports to understand the lapses that have
occurred in the company and tries to find solutions to overcome them. The task of
modern day professionals or executive is to prepare reports from time to time. The
objective of the report is to help an executive understand and evaluate a problem
so that he can take immediate actions and rationalize it.
Likewise, writing report is important in our business dealings apart from our
personal tasks. A good report in a business world includes the ability to understand
a problem and then suggests solutions for it. A professional come in touch with a
variety of people having different needs. Not all of them understand our ideas and
thoughts. Hence, the need to communicate in a language that is understandable to
all is one of the basic features of technical writing.
DEFINITION & NATURE OF TECHNICAL WRITING
Technical writing or report writing is giving an account or description of an
aspect of a particular art, science, trade, or profession learned by experience, study,
observation or investigation.
Technical writing aims to get work done, to change people by changing the
way they do things. (M. Jimmie Killingsworth and Michael K.Gilbertson)
Technical writing is a writing desired to meet specific goals.
The purpose of technical writing is for an effective communication.
COMMUNICATION
It is derived from the Latin word communicatus which means to impart or
share. It is giving or exchanging of information, signals or messages by means of
talking, gestures or writing.
It is defined as imparting or interchange of thoughts, opinions, or information by
speech, writing or signs. (American College Dictionary)
Characteristics of Communication
Decoder
Encoder
Receiver
Message
Feedback
Shannon Weaver
Model
Sender
The sender is the first important element of a communication process. He transmits
or disseminates information to those he wants to and to those who are in need of it.
During the time the sender composes the message, the background, attitude and
mood of the sender comes under scrutiny. A slight lapse on the part of the sender
may affect the fortune of group, community or even a nation. The sender has to be
responsible while sending a message.
Message
The message is also equally important. Message is the information that the sender
sends. It is an idea, sometimes data, a meaningful utterance or statement issued by
the sender. The message maybe in the form of words, symbols, gestures, etc.
Nowadays, gadgets are available to send message in different forms.
Channel
It is the medium through which the sender transmits the message or idea. The
selection of the channel depends on the mood and receivers expectation, and the
situational need. It can be sent using technology, writing and other channels. When
dealing with official responsibilities, written messages is more effective.
Receiver
The person for whom the message is intended is the receiver. For a successful
communication process to take place, the type of relationship of the sender and
receiver comes into the picture. Familiarity facilitates decoding. People working in
similar types of organization or discipline can understand and decode each others
message better than others. The receiver should be careful in decoding message.
Never jump to conclusions in haste for a hasty response may result in wastage of
time and undue problems.
Feedback
When a sender sends a message, he waits for a response. There are times when the
sender doesnt receive a response. The sender in such a situation starts checking
what went wrong. The examination or evaluation of the receivers response is called
feedback that helps the sender the effectiveness of the message. Nowadays,
feedback is one of the best measuring scales to bring further improvement and
overcome lapses in ones work. While response is the reaction of the receiver,
feedback is the analysis of the nature of the response.
TYPES OF COMMUNICATION
a. Interpersonal Communication
It is a communication that takes place between two (2) persons. It is called
interpersonal communication when one communicates with another using
words or symbols. Its success depends on the familiarity of knowledge,
background and experience of the individuals involved. This happens in small
group discussion, meetings, interviews, letters, reports, etc.
b. Intrapersonal Communication
When an individual talks to himself is intrapersonal communication. The word
intra means within and, thus, intrapersonal communication is talking to
ones self.
c. Extrapersonal Communication
Human beings also communicate with animals, inanimate objects and their
surroundings. This is termed extrapersonal communication.
COMMUNICATION FLOW
a. Internal Communication is when information and ideas are exchanged within the
organization.
e.g. internal memo or advisories, informal exchange of information, etc.
b. External Communication occurs when information and ideas are sent outside the
organization.
e.g. advertisements, announcements, collecting bills, etc.
Forms or Channels of Communication
a. Downward Flow
Communication from higher authorities is sent to the bottom of the organization.
Usually notices, reminders, announcement, instructions and others.
b. Upward Flow
It comes from subordinates and moves upward to their superiors, junior level
employees to their bosses. Communication through this means aim at helping
the bosses perform their tasks efficiently and keeping them informed of recent
developments. The medium can be phones, letters, reports, etc.
c. Horizontal flow
It is a communication that takes place between people of equal status and peer
groups. This flow of communication takes place when some important decision is
to be made. Decision regarding employment and retrenchment, signing
contracts, agreements or collaborations, passing new policies, etc. are some of
the topics discussed on this level.
THREE ELEMENTS AT ONE OR MORE STAGES OF THE TECHNICAL WRITING
PROCESS
1. The problem or subject matter is not so popular knowledge but, rather is so
specialized that it belongs to art, science, medicine, engineering,
architecture, business, or the like.
2.
Study, investigation, observation, analysis, experimentation, and
measurement to be able to collect accurate and precise information about
the problem or subject matter.
3. The organization and presentation of the information thus gathered so that it
will be clear and meaningful to the intended readers.
The final product is of this three-stage process is called a TECHNICAL REPORT which
may range from a simple letter or memorandum to a voluminous report or stack of
books.
CHARACTERISTICS OF TECHNICAL WRITING
1. Technical writing treats subject matter related to the fields of science and
technology and lately has involved other disciplines such as economics,
medicine, psychology, agriculture, radiology, business administration, and
others.
2. Technical writing is characterized by certain elements such as the use of
scientific and technical vocabulary, its use of graphs and visual aids and
its use of conventional report forms.
3. Technical writing observes impartiality and objectivity, shows extreme care
to convey information accurately and concisely and avoids any attempt to
arouse emotion.
4.
Technical writing uses certain complex writing techniques such as
definition, classification, description of mechanisms, description of
processes, exemplification, casual analysis and others.
5. Technical writing has practicality and power. Practical because it is
situational and addresses a particular purpose and audience. Powerful
because it make things happen.
6. Technical writing used to involve only engineers and architects as its
primary audience. Today, however, technical writing begins to attract
students from many disciplines.
7. Technical writing courses are worthwhile because they have a high carryover value beyond the college days.
A study conducted by Professor Richard M. Davis of Engineers of Distinction led him
to the following conclusions:
-the respondents spent an average of 24.35 percent of their time writing,
-the respondents spent 31 percent of their time working with other peoples
written materials,
COHERENCE
-logical togetherness of the material
-clear passage of thought from one point to another
CONFIDENCE
-knowing more of the subject matter than anyone else
-you become the authority
-you must be convinced of your work
DIGNITY
-formality with respect to the words and its use
-pronouns like which and that should be used. i.e. Miss Reyes informs us that a
comet will . . and not Miss Reyes informs us a comet . . .
-contractions like dont, cant, want and others should be avoided.
-simple dignity can be achieved with straight forward expressions.
EMPHASIS
-main points are emphasized
-there is distinction between main topics and illustrations or main points or
subordinate points
FACILITY
-Facility is making the report easy to read
-For facility, report writing should observe pacing, sequence, arrangement &
continuity.
1. Pacing is presenting technical and unfamiliar information in small
segments, explained and defined or illustrated before more of such
information is presented.
2.
Sequence is leading the reader from familiar to unfamiliar,
simple to complex, from whole to parts.
3.
Arrangement is emphasizing and balancing important parts to
show their proper relationship and importance.
4.
Continuity is showing the relation of one part to another, clearly
stated, illustrated & emphasized.
GRAMMATICAL CORRECTNESS
-Refers to the communicative skills of the writer, i.e., correct grammar, spelling, etc.
Technical writing should have a proper grammatical structure. This could not be
ignored in technical writing. A technical writing should be free from errors and
poetical experiments. A grammatically correct document brings a good impression.
The omission of punctuation may mar your fortune. Wrong spelling is another
detriment to your chances of getting an assignment. It reflects your background and
at times your culture. (Sangeeta Sharma and Binod Mishra)
HONESTY
-Acknowledging the use of other peoples information or work either in footnotes or
in text
-It also involves reporting your own failures and mistakes as well as successes in the
hope that it will provide a clue for some researcher working on a similar subject
from a different angle.
ILLUSTRATION
-Graphics or visuals such as charts, diagrams, photos, graphs
-It is used to show a trend, situation or movement
JUDGMENT
-Judicious weighing of evidence
-The evidence must be
1.
2.
3.
4.
most ample
most pertinent
most simple in explaining facts with least additional evidence
most in harmony with the rest of the available evidence.
KNOWLEDGE
-The communication of knowledge is one of the chief functions of report writing.
-Knowledge is gained by the reader from the technical report.
LOGIC
-Thinking straight
-Putting things in their proper perspective
-Statements must not contradict each other
-Words must be used in a consistent sense
-Statements must move in one direction
-Judgments must not be based on a few data
-Cause and effect should be clearly distinguished from simple sequence
-Conclusions should not be inferred if they have no connection with the data
-An authority should not be accepted if he is biased and not an expert in that
particular field
MECHANICAL NEATNESS
-Neatly typed and well margined
-Free from typographical errors, cross-outs
NORMAL PROCEDURE
-Conformity to standards
-Making the report easier to understand
OBJECTIVITY
-Impartial point of view of the writer
-To achieve this is to avoid the use of the first person (I, me, my) except in short
informal reports.
QUALIFICATION
-Qualifying is explaining the circumstances surrounding your work because it might
have affected the results you are reporting This is true under this given condition
-What factors were constant and factors were variable as you worked.
STRAIGHT SENTENCES
-The subject coming first followed by the verb
-Limit a sentence to one idea or two closely related ideas
THOROUGHNESS
-Treat your subject fully so that your report shall have a lasting value.
-How to achieve thoroughness?
1. Prepare a checklist of requirements in the planning stage,
2. Marking off each requirement as it is fulfilled,
3. Use the checklist again in the revision stage for a final recheck
UNITY
-Unity implies that all the details and facts in the report are clearly relevant to the
main point under the discussion.
-Ask the question, What has this to do with the subject?
-Draw a line from the subject of a paragraph to the subject of the next.
-Make an outline
VERACITY
-Veracity means truthfulness.
-Truth is the soul of science.
-Sticks to facts.
5.
6.
7.
8.
9.
10.
11.
12.
TREATISES
PROPOSALS
ARTICLES FOUND IN TECHNICAL JOURNALS
SPECIFICATIONS
MONOGRAPHS
BROCHURES
PAMPHLETS
MEMORANDA