You are on page 1of 28

Noha Mansy

Assistant Lecturer – English Department

sinaiuniversity.net
Traits of Technical Writing Slide 3

Accessible Document Design Slide


5
Audience recognition
INDEX

Slide 12
Accuracy Slide 21

Exercises Slide 25
@Sinaiunieg in
fo@su.edu.eg
www.su.edu.eg
Traits of Technical Writing

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Technical Writing has to fulfill some specific
Traits (or
criteria of Technical Writing
traits) to be successful. The five
traits of technical writing are:

1. Clarity
2. Conciseness
3. Accessible Design
4. Audience recognition
5. Accuracy

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
3. Accessible Document Design

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Traits of Technical
In addition to clarity and conciseness, a Writing

third trait of effective technical writing is

accessibility.

Accessible Design

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Example to explain:
Traits of Technical
Writing

Accessible
Design

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
The paragraph on the previous slide Traits of Technical
consists of 84 words and ten sentences. Writing
The average number of words per
sentence is only 8.4. the
Because
sentences are not too long, the writing
is concise. Next, the text is clear, due to Accessible
Design
specificity of detail.

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
However, despite the clarity and Traits of Technical
conciseness, this writing Why? Writing
Essentially, fails. this is
paragraph
unintelligible The page layout makes it
.nearly impossible for the reader
to understand the text. Accessible
Design

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
An accessible Version of the same info:
Traits of Technical
Writing

Accessible
Design

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Some Techniques used to make
a document accessible are: Traits of Technical
Writing
Headings Subheadings,
Italics Underlining
Graphics Figures
White Space Tables
Accessible
Column Lines Font Sizes
Design
Numbered Lists Bullets

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
4. Audience recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Successful technical writers know
that Traits of Technical
they can only achieve clarity by Writing
recognizing their audiences.
Basically,
our students will write to either High
Tech Peers, Low Tech Peers, or Lay
Readers. These three audience levels Audience
have the following traits. Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
High Tech Peers : know as much about a
subject matter as you. Traits of Technical
They the same job title, Writing
have same same of
education,
and the same
years
level of expertise.
experience,
For example, a medical
doctor writing
another medical to
doctor would Audience
Recognition
be writing High Tech to High Tech.

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Writing to High Tech Peers :
Traits of Technical
Writing
When writing to a high tech peer, one
can use acronyms and abbreviations,
usually without any definition.

Audience
Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Low Tech Peers : who work in
company and knowyoursomething about Traits of Technical
the subject matter. Writing
They may not have the same job title,
education, years of experience, or
level
of expertise. For example, a medical
doctor writing to a staff nurse would be Audience
writing High Tech to Low Tech. Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Writing to Low Tech Peers :
Traits of Technical Writing
When writing to a low tech peer, one

can use acronyms and abbreviations,


usually but with a definition or with an
explanation. Audience
Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Lay Readers : are your customers.
Traits of Technical
They are completely out of the loop. Writing

For example, a medical


doctor communicating with a patient.

Audience
Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Writing to Lay Readers :
Traits of Technical
Whereas high tech readers do not need Writing
acronyms or abbreviations defined, and
low tech readers need a parenthetical
definition, lay readers want to avoid the
confusion completely. All they want
is the definition of
abbreviations
acronyms. In fact,orthey might also need Audience
follow-up explanations. Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Traits of Technical Writing

Audience
Recognition

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
5.
Accuracy

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Traits of Technical Writing
Effectiv technical writing must be
e whether grammatically
correct,
mathematically, ,
electronically, etc.

Accuracy

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Techniques to proofread what we write: Traits of Technical
Writing
-Use the computer’s spell check
remember, however, that a spell check will not
catch form if you mean from, to if you
mean too, or except if you mean accept.

-Let it sit for a day or a weekend. When


the document is cold, writers are more Accuracy
objective about their own writing.

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Techniques to proofread what we write: Traits of Technical
Writing
- Use peer evaluations.
others will see the errors we miss.

- Read it aloud
sometimes we can hear errors.

- Read it backwards
then you read words out of context. Accuracy
You cannot anticipate the next word.

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
Exercises

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
1.This paragraph is clear and concise but it is
not technical though, tell why ? And rewrite it in order to be
technical:

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
2. You are an IT Engineer. You and your Team have developed a
new operating system with new technology of using applications.
In three different paragraphs tell High Tech Peers, Low Tech
Peers, and Lay Readers what you have accomplished :

@Sinaiunieg info@su.edu.eg www.su.edu


.eg
THANK YOU

For any questions feel free


to contact me by mail
Noha.mansy@su.edu.eg

Noha Mansy
Assistant Lecturer – English Department

You might also like