0% found this document useful (0 votes)
29 views41 pages

Understanding Technical Communication

Technical communication aims to empower readers by preparing them for effective action. It is audience-centered, designed, and responsible. Technical communication is audience-centered as it has definite purposes, enables readers to act within their communities, is appropriate for its audiences, and is interactive. It is designed through its appearance on the page using headings, chunks, visual aids, and hyperlinks, as well as through its content structure. Technical communication is responsible as it takes an ethical approach and considers stakeholders. It also needs to be adapted globally through localization for other audiences and cultures.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PPTX, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
29 views41 pages

Understanding Technical Communication

Technical communication aims to empower readers by preparing them for effective action. It is audience-centered, designed, and responsible. Technical communication is audience-centered as it has definite purposes, enables readers to act within their communities, is appropriate for its audiences, and is interactive. It is designed through its appearance on the page using headings, chunks, visual aids, and hyperlinks, as well as through its content structure. Technical communication is responsible as it takes an ethical approach and considers stakeholders. It also needs to be adapted globally through localization for other audiences and cultures.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PPTX, PDF, TXT or read online on Scribd

TECHNICAL

COMMUNICATIO
N
2

1.
What is Technical
Communication?
3

“Writing that aims to get


work done, to change
people by changing the
way they do things”

Authors use this kind of


writing “to empower
readers by preparing them
for and moving them
toward effective action”
4

2.
Major Traits of
Technical
Communication
5

Technical communication is:

» Audience-centered
» Designed
» Responsible
» Global
6

Technical
Communication is
Audience-centered
7

» Technical communicators create documents that aim to


help readers act effectively in the situations in which
they find themselves.

» “a document . . . works for its users” in order to help


them
⋄ Find what they need
⋄ Understand what they find
⋄ Use what they understand appropriately
8

“Audience centered” means that technical


communication:
⋄ Has definite purposes
⋄ Enables readers to act
⋄ Occurs within a community
⋄ Is appropriate
⋄ Is interactive
9

1. Has Definite Purposes


» Technical writers enable their readers to act in three
ways:

⋄ by informing

⋄ by instructing

⋄ by persuading
10

2. Enables Readers to
Act

» Readers act in a way that


satisfies their needs.

» Their needs include


anything that they must
know or do to carry out a
practical activity.
11

3. Occurs within a Community

» Action occurs within a


community, a loosely or closely
connected group of people with
a common interest

» Belonging to a community
affects the way a person acts
and expects other members to
act
12

» It means understanding how to present your


material so that readers get the information that
they need in the form that they expect it.

» This concept means that readers expect writing—


all communication, actually—to flow in a certain
way, taking into account various factors that
range from how a document should look to what
tone it projects..
13

4. Is Appropriate
» Because communication takes place within a
community, it must be appropriate, which can have
two meanings in communication:
⋄ the material needed in the situation is present
⋄ or the material is socially acceptable (social
appropriateness, or accurately representing the
relationships in the situation)
Word choice is often very important
 “I felt that there was needless repetition in what you
wrote.”
 “I felt that the text would be easier to read if the
sections were combined.”
14

5. Is Interactive
» The key to all community exchanges
is that they are interactive.
» Readers read the words in the
document, but they also apply what
they know or believe from past
experiences.
» As the words and the experiences
interact, the reader in effect recreates
the report so that it means something
special to him or her, and that
something may not be exactly what
the writer intended.
15

Technical
Communication is
Designed
16

» Technical writers use design to help their


readers both find information and understand
it

» Design has two ingredients—


⋄ the appearance on the page
⋄ the structure of the content
17

1. Design the Appearance


» Helps readers locate information
and see the relationship among
various pieces of information.
» The basic design items that
writers use are
⋄ Headings
⋄ Chunks
⋄ Visual aids
⋄ Hyperlinks
18

i. Headings
» Words or phrases that name the contents of the
section that follows

» Also indicate where the units begin and end

» Readers can navigate easily to the information


they need
19

ii. Chunks
» Any block of text

» The basic idea is to use a series of short blocks


rather than one long block

» Readers find shorter chunks easier to grasp


20

iii. Visual Aids


» Graphs, tables, and other media
» Writers commonly use visual aids to present:
⋄ collections of numerical data (tables)
⋄ patterns or trends in data (graphs)
⋄ examples of action (a short video clip showing how
to connect to internet)
» Documents that explain experiments or projects almost
always include tables or graphs.
» Manuals and sets of instructions rely heavily on
drawings and photographs, and those delivered in digital
format may include audio or video clips.
» Feasibility reports often include maps of sites.
21

iv. Hyperlinks

» Specific to Web documents, hyperlinks are words


embedded in the document that help the reader
navigate to more information about a particular
subject.
» Hyperlinks are denoted by a different-colored
text, and are typically underlined.
» Clicking on a hyperlink within a document will
take you to a different page—or a different
location on the same page—that contains more
information about the highlighted word or phrase.
22

2. Design the Content


» It means selecting the sequence of the material and
presenting it in ways that help the reader grasp it.

» Two common methods to use are :


⋄ Arrange the material top-down
⋄ Establish a consistent visual logic
23

i. Arrange the Material Top-


down
» Top-down means putting the main
idea first.

» Putting the main idea first


establishes the context and the
outline of the discussion.
24

ii. Establish a Consistent


Visual Logic
» It means that each element of format
is presented the same as other
similar elements

» The key to this strategy is


consistency
25

Technical
Communication is
Responsible
26

» Technical writing is an ethical endeavor. The key


principle here is to take responsibility for your
writing.

» You take responsibility because your readers, your


employer, and society— also called “stakeholders”—
rightfully expect to find in your document all the
information necessary to achieve their goals, from
assembling a tricycle to opening a factory.

» In the text of your documents, then, you must tell the


truth and you must do all you can to ensure that your
audience understands your message.
27

Definition of Ethics
» Ethics deals with the question, What is the right
thing to do?

» Communicator must act not for self-gain but for


the good of the community, or for the
stakeholders in the situation.
28

Ethical Situations
» Situations in which a person would have to make
ethical decisions, and face consequences from
those decisions
» the employee becomes aware that the company is
doing something illegal or that could cause great
harm
» E.g. Space shuttle Challenger disaster
29

» This kind of decision—and action—is incredibly


intense, requiring more than just a sense of what
is the right thing to do. It requires courage to
accept the negative consequences on self, and
family, that losing employment entails.

» Each person must ask himself or herself how to


respond in a situation like this, but the ethical
advice is clear—you should blow the whistle.
30

» What is ethical behavior in technical


communication situations?

» Experienced technical communicators suggest


three actions:
⋄ Talk to your colleagues
⋄ Trust your intuition
⋄ Talk to your boss
31

Technical
Communication is
Global
32

» Business is international, and so too are writing and


communication
» As a result, people must now deal with the many languages
and cultures throughout the world on a regular basis
» In intercultural communication you need to give special
consideration to cultural factors and to strategies for
adapting communication for a variety of audiences
» The basic strategy for adapting writing and communication
to other cultures is localization.
» “The process of creating or adapting an information
product for use in a specific target country or a specific
target market”
33

1. Radical Localization
» Radical localization deals with those areas that affect
the way users think, feel, and act.
» These areas include rules of etiquette; attitudes
toward time and distance; the rate and intensity of
speech; and local systems of economics, religion, and
society—even the way people go about solving
problems
» In order to perform radical localization you must be
able to look at social behavior from another culture’s
point of view, so that you can understand the thinking
patterns of the other person’s culture
34

i. Another Point of View


» For example, in China the color red is associated
with joy and festivity; in the West red can mean
stop, financial loss, or revolution
» In the United States, janitor usually means a
person who maintains a building, and is often
associated with sweeping floors. But in Australia
that same job is called a caretaker—a word that
in the United States usually means someone who
maintains the health of another person
35

» Levels of personal acquaintance differ in business


relationships in other cultures. In the United States,
people often conduct business, including very large
sales, with people whom they hardly know, but in
many countries people prefer to achieve some kind of
personal relationship before entering into any
significant business arrangement with them.

» The best method for gaining familiarity with another


culture is to interact with members of that culture,
whether those interactions occur in person or online
36

ii. Role of Direct and Indirect Messages


» In the United States we teach that the direct
method is best: State the main point right away
and then support it with facts.
» In some other cultures, that approach is unusual,
even shocking.
» Although in the United States a writer would
simply state in an e-mail that he or she needs a
meeting, in a web culture, like China’s, that
request would come near the end of the message,
only after a context for the meeting had been
established
37

2. General Localization
» General localization deals with items, usually
details of daily life, that change from country to
country, for instance, date format, currency, and
units of measurement.
» These concerns fall into two broad areas:
⋄ culture-specific references
⋄ style.
38

i. Culture-specific References
» These items are often so ingrained that they are
“invisible” to people in the culture—they are just
the way things are done.
» Time formats. Countries configure the calendar
date differently; some use month/day/year, others
use day/month/year.
» Weights and measurements
» Currency
39

» Telephone numbers and addresses. In the


United States, telephone numbers are grouped in
threes and fours—715-444-9906, but in other
countries they are often grouped by twos—33
(0)1 23 34 76 99
In the United States, it is common practice
to address an envelope with the name at the top and
list in descending order the street address and city. In
some countries, Russia, for instance, the address list
is reversed; the country is placed on the first line and
the name of the person on the bottom line
40

ii. Style
» Avoid using slang and idioms
» Avoid using humor
» Use glossaries. If you must use jargon or other
specialized language, be sure to include a glossary of
definitions.
» Don’t use long noun phrases. Often English speakers
string together a series of nouns. “Damage recovery
results,” for instance, could be the results of damage
recovery or the act of damaging those results. To avoid
misinterpretation, rewrite the phrase for the non-native
speaker: “results of the damage inspection.”
41

» Use clear modifier strings. Consider the phrase


“black effective keyboards and mouse pads.”
Does this mean that both the keyboards and
mouse pads are black and effective? Or just the
keyboards? To help non-native speakers, you
need to express the material in a more precise,
though longer, form: “mouse pads and black
effective keyboards” or “keyboards and mouse
pads that are black and effective.”

You might also like