Technical Writing - Applied English Course TEAMS
Technical Writing - Applied English Course TEAMS
Technical Writing
This is a suggested textbook for “ The Applied English Course”. Here you will
find some notes, tips, activities, extra material, evaluation sheets and assignments.
The Guide is based on The Language Center textbook “Technical Communication: Process
and Product, 2009, by Sharon J. Gerson and Steven M. Gerson, 6th ed., New Jersey: Pearson,
Prentice Hall. However, not all material is cover. I found through my workplace experience that
some technical areas have more focus than others, so here comes the summary:
2|Page
Technical Writing: Chapter One
A Definition
Technical writing is
communication written for What is
and about business and
industry, focusing on Technical Writing?
products and services:
how to manufacture them,
market them, manage
them, deliver them, and
use them.
Technical writing is
written:
* In the work
environment (in
the office, from
8:00 to 5:00, not
counting
overtime). Of course, there are exceptions…
*For supervisors, Why is technical writing so important?
colleagues,
subordinates,
vendors, and Why would I want to teach technical writing?
customers. Don’t I have enough to teach now without adding one more
assignment or series of assignments to my curriculum?
Technical writing, which What’s the point?
must be understood easily
and quickly, includes: Technical writing is not literature; it’s neither prose which recounts
• memos and e-mails the fictional tales of characters nor poetry which expresses deeply felt,
• Letters universal emotions through similes and metaphors.
• Reports Technical writing is neither an expressive essay narrating an occurrence
• Instructions nor an expository essay analyzing a topic.
• brochures and Technical writing is not journalism, written to report the news.
newsletters
Technical writing does not focus on poetic images, describe personal
• the job search experiences, or report who won the basketball game.
• web pages
• fliers Instead, technical writing is:
—an instructional manual for repairing machinery
• PowerPoint
—a memo listing meeting agendas
presentations —a letter from a vendor to a client
• graphics —a recommendation report proposing a new computer system
3|Page
Of course there are exceptions …
4|Page
People read literature for pleasure, essays for enlightenment,
and journalism for news. People read technical writing to
accomplish a job. Technical writing is written to a different audience
for a different purpose than essays. The reader of technical writing
does not have time, nor necessarily the interest in the subject
matter.
5|Page
COMMUNICATION:-
6|Page
Perhaps finding a job would not be a big deal in case of if the candidate is well connected
and belongs to a well off family. But promotion on the job requires some extra skills on the part
of the candidate. Amongst those skills, communication abilities rank on the top. If a person can
speak well during interactive and presentation sessions, can reports properly, he will
automatically be in the eyes of the management and whenever a chance for promotion comes, he
will be on the top of the list.
1. It is the language spoken in office, business It is the language spoken at home or with
and other formal places. friends.
2. Proper and standard words are used Improper words and slangs are used.
3. It consists of specific purpose words like It has all purpose words like “boss” that
manager, supervisor, owner, employer etc. stands for various personalities.
7|Page
Explain the process of communication. OR “Communication is a two way process of
exchanging ideas or information between two human beings”. Explain this statement with the
help of a diagram.
Communication simply means exchange of ideas & information between two persons. A
person sends a message to another person and gets the response from the receiver on the
message. This whole phenomenon can be explained as under.
8|Page
Discuss five elements (Factors) of the process of communication;
Communication is the exchange of ideas between two minds. This process of exchanging
idea is based on following five factors.
1. Sender:
Sender is the person who initiates the process of communication. He generates an idea in
his mind regarding production invention, innovation, request, order, enquiry etc. So, he is the
first factor of communication process and his function is to generate an idea. Therefore, it is
necessary that the idea should be clear, and convertible into message. For this purpose, the
sender needs to apply their knowledge and imaginative power.
2. Message:
The idea in the mind of sender is transformed into words that is called message. The
sender decides on the length, style, organization and tone of the message. The message may be
presented in many ways, depending on the subject, purpose, audience, personal style, mood and
cultural background.
3. Media:
The media of transmission of message are electronic media as T.V., radio, computer and
print media as newspapers, letter, magazine etc. media play a very important role in helping the
receiver’s understand the message. A wrongly chosen medium can interrupt the process of
communication, Selection of medium depends upon message, audience, urgency and situation.
4. Receiver:
Receiver is the person who gets the message from the sender, decodes it, understands it
and interprets it.
5. Feed Back:
Having understood the message, the receiver responds to the sender in yes or no or asks
further questions. This process is called feedback.
Explain in detail verbal and non-verbal communication?
9|Page
In order to send message in business, speaking plays a vital role. Giving instruction,
conducting interviews, attending meetings, sending orders through telephone calls are very
common in today’s business.
2. Writing:
It is used when a complex message is sent. Placing order through letters,
informing employees through circulars, sending reports and memos, filling different
government forms, keeping records in writing are some examples of this aspect of verbal
communication.
3. Listening:
People in business spend more time in obtaining information then transmitting it.
Listening is the most important way to receive information: information regarding order
of employers, instruction, rules and regulation, customer trend etc, are obtained through
listening. But in listening, people generally forget 75% of the message after few days.
4. Reading:
Reading reports, memos, policies, circulars, and different business statements are
essential for an organization: Reading involves understanding and interpreting the
material.
NON VERBAL COMMUNICATION: It means communication without the use of language or
words. It includes appearance, body language, silence, etc. Its explanation is as follows.
1. Facial Expressions:
Face and eyes are helpful means of nonverbal communication. They reveal hidden
emotions such as anger, confusion, enthusiasm, fear, joy etc.
2. Gestures, postures & movement:-
Postures means the language primarily composed of hand and fingers. Communication of
deaf people and signal given by traffic constable are the example of posture. Gestures and body
movement also indicate many things. Shaking hand with firmness indicates a warm relationship,
moving back and forth reveals nervousness.
10 | P a g e
NON-VERBAL COMMUNICATION:
Non-verbal messages are sometimes more clear, accurate and effective as compared to
verbal communication, because they are internationally used and understood. Non-verbal
communication may be divided into the following three categories:
1. Appearance
2. Body Language
3. Silence, Time and Sounds
1. APPEARANCE:
Appearance affects the quality of written and spoken messages as follows:
i. Written Messages:
The envelope’s overall appearance size, colour, weight, postage and the letter’s
overall appearance length stationary, enclosures, layout, etc. may convey significant
information and impressions.
ii. Spoken Messages:
Personal appearance of the speaker-clothing, jewelry, hair-style, neatness, etc.
may tell about the age, sex occupation, nationality, social, economic and job status.
Similarly, appearance of the surroundings room-size, location, furnishings, lighting, etc.
may tell a lot about the message.
2. BODY LANGUAGE:
Facial expressions, gestures, posture, smell, touch, voice etc are included in body language.
11 | P a g e
3. Quickness:-
A denial or acceptance expressed by moving head saves lot of time. So, it is important in
this respect that non-verbal communication transmits the message quickly.
12 | P a g e
This chapter provides specific criteria to give students before asking
them to write technical documents. The five traits of technical writing
are:
• Clarity
• Conciseness
• Accessible document design
• Audience recognition
• Accuracy
13 | P a g e
Clarity in technical writing is mandatory
The most important criteria for effective technical writing is clarity. If the audience
responds to a memo, letter, report, or manual with, “Huh?” what has the writer
accomplished? If the correspondence is not clearly understood, the reader will either call
the writer for further clarification, or just ignore the information. In either case, the writer’s
time is wasted; the reader’s time is wasted; the message is lost.
Clarity, however, is not just a time concern. Think of it from this perspective: your
company has written an installation manual for a product. The manual, unfortunately, is
not clear. When the reader fails to understand the content, three negatives can occur:
• BAD—The equipment is damaged. This requires the owner to ship the equipment
back. The company will replace the equipment, costs accrue, and public relations
have been frayed.
• WORSE—The owner is hurt, leading to pain, anxiety, doctor’s bills, and bad public
relations.
14 | P a g e
• EVEN WORSE—The company is sued. The company loses money, the writer of the
manual loses a job, and public relations are severed.
Example
1. Who is the audience? Who will know what? Will the audience know a great deal
(High Tech)? Will the audience know a little about the topic (Low Tech)? Will the
audience know nothing about the topic (Lay)?
2. What do you plan to do? What do you want the audience to do? What do you want
to know?
3. When the job should be completed? What’s the turnaround time? What’s the
timetable? What’s the desired schedule? When do you need an answer?
4. Where will the work take place?
5. Why is the task being undertaken (the rationale, motivation, goal)? Why is the
desired date important?
6. How should the task be performed? What’s the preferred procedure?
15 | P a g e
Using the reporter’s questions checklist as a prewriting tool, the previous memo can be
revised to greater clarity. Here is an example of a revised memo.
16 | P a g e
Clarity achieved through specificity
If a memo sent to six employees states that the company has lost a
substantial amount of business, will all employees acquire the same
knowledge? One might assume that a substantial loss equals $1,000; another
might assume that a substantial loss equals twelve clients. In each case, the
employees are guessing, and that is not the goal of successful technical
writing.
(The previous memo using the phrase very detailed would be more
clear if the writer had said he needed an eight hour presentation. Everyone
receiving the memo then would know exactly how much time they needed to
set aside to attend the meeting.)
The ultimate goal of effective technical writing is to say the same thing to
multiple readers!
17 | P a g e
Read the following paragraph taken from an actual business correspondence:
18 | P a g e
No one curls up in bed at night and for pleasure reads manuals
about installing computer printers.
19 | P a g e
Technical writing must fit in the box
20 | P a g e
21 | P a g e
You can shorten a sentence by avoiding:
- Redundancy
- Prepositional phrases
- Passive Voice.
(1)
“Avoiding Redundancy”
(2)
(3)
22 | P a g e
“Avoiding Passive Voice”
23 | P a g e
24 | P a g e
The paragraph on the bottom of the previous page consists of 84 words
and ten sentences. The average number of words per sentence is only 8.4.
Because the sentences are not too long, the writing is concise. Next, the text is
clear, due to specificity of detail. However, despite the clarity and conciseness,
this writing fails. Why? Essentially, this paragraph is unintelligible.
The page layout makes it nearly impos-
sible for the reader to understand the text.
25 | P a g e
Who is writing to whom?
What does the audience Know, need to know, and want to
know?
***
When your audience fails to understand the text, you have
failed to communicate!
26 | P a g e
Writing successfully to these three types of audience requires different
techniques
27 | P a g e
28 | P a g e
29 | P a g e
Proofreading
A successful technical writer assures that the document is well-
proofread. This can be achieved through:
30 | P a g e
Tip No. (1)
31 | P a g e
32 | P a g e
33 | P a g e
34 | P a g e
35 | P a g e
Types of Letters
36 | P a g e
37 | P a g e
38 | P a g e
39 | P a g e
40 | P a g e
41 | P a g e
42 | P a g e
43 | P a g e
44 | P a g e
45 | P a g e
46 | P a g e
47 | P a g e
48 | P a g e
49 | P a g e
50 | P a g e
51 | P a g e
52 | P a g e
53 | P a g e
54 | P a g e
Components of a good “Resume”
55 | P a g e
56 | P a g e
57 | P a g e
58 | P a g e
If your résumé finds appeal, you would probably have a chance for an
interview, so get ready and follow the interviewing common sense:
59 | P a g e
Interview
Explain the types of patterned interview.
In a patterned interview the interviewer controls the direction of conversation. It is of following
two kinds:
1. Direct Interview: In the direct interview the interviewer keeps very close control at all times
by directing limited and specific question. He / She asks close ended question and does not let
the interviewee speak freely.
2. Indirect Interview: In the indirect interview the interviewer makes little or no attempt to
direct the applicant conversation.
Other objectives
60 | P a g e
There are following objectives of patterned interviews.
1. The resume provides a lot of information about the candidate but not all the information so
this interview is conducted to evaluate job qualification that the resume can’t provide.
2. Another purpose is to determine the real communication ability of the interview.
3. This interview also helps the interviewer provide essential facts about the job and company.
4. It also instills a feeling of material understanding and confidence in the applicant, who accepts
the job.
5. It promotes good will towards the company, whether the applicant accept the job or not. It is
important to give the right impression to the candidate who is disappointed by a turndown.
A. Direct Interview:
Positive Negative
Smiles Frowns
61 | P a g e
B. Verbal Behavior:
Positive Negative
62 | P a g e
63 | P a g e
64 | P a g e
65 | P a g e
66 | P a g e
67 | P a g e
68 | P a g e
69 | P a g e
References:
Technical Communication: Process and Product, 2009, by Sharon J. Gerson and Steven M.
Gerson, 6th ed., New Jersey: Pearson, Prentice Hall
The End
70 | P a g e