Professional Documents
Culture Documents
Presentation No.5 (Section B)
Presentation No.5 (Section B)
MUHAMMAD
HAIDER
JAVED
NISAR
2013-EE-476
2013-EE-
466
MUHAMMAD
UMAIR
2013-EE-452
ADNAN
SARAM
2013-EE-490
SHEIKH
BILAL MEHMOOD
2013-EE-443
TECHNICAL
&
NON-TECHNICAL
WRITING
manuals
System manuals
Step-by-step
procedures
On-line help
Training manuals
Quick-reference
guides
How-to video scripts
Information to convey:
An expert must translate formulae, numbers, research and other technical
concepts into a written form that is understandable to guarantee an action or outcome
Purpose of writing:
To inform
To instruct
To propose
To persuade
To recommend
Characteristics
Recognize the audience:
The nature of the audience determines the level of technical detail, the
amount of context/background information you provide, and the
organization of the document.
Brevity:
pare your language down to shortest message you can to get across to your readers.
Make ideas and information clear:
Technical writing is known for its use of
headings and subheadings and for the way information is made easily accessible by grouping
material
Characteristics
introduction : always provide the big picture before jumping into the
detail
Body: this is where information and technical details are given
Conclusion: this is where the main points are reemphasized
technical
Technical writing
Structure
Structure
Fairly flexible structures
tone
More personal even
subjective.
less formal
Tone
Vocabulary
Technical writing
genre
Vocabulary choice
Topic sentences
Genre:
Vocabulary choice:
Words have more specific,
technical meanings (e.g., theory
=conceptual framework)
Topic sentences:
Technical writing
Vocabulary Usage
Some
redundancy or repetition of words or
ideas
verb forms
Vocabulary usage:
verb forms
Deficit model: A mode of thinking held by some scientists that communication with the
public is top-down and one-way
Readability: a statistical measure of the complexity of text. The longer the words and the
sentences in a sample of text, the less readable it will be
Super-compression: leaving out transitional and contextual material that might otherwise
help to clarify the meaning of a passage
Example of ambiguity
original
Re-write
Over-long
sentences:
Re-write
Creative writing
A characteristic of this type of writing is the use of expressive and descriptive language.
creative writing
Writing, with
usually for
detective
Creative writing
Audience of creative writing:
addressed
appropriately
Creative writing
Entertainment purpose:
Countless books and magazines have reader entertainment as their primary objective. This
is not technical writing.
Proposalsa document that describes the purpose of a project, the tasks that will be
performed in the project, the methods used to complete the project, and finally the cost
of the project.
Technical reports
White papers
Web sites.Technical writers of today are often responsible for authoring pages on
Press releases
public.
Specificationsare design outlines that describe the structure, parts, and delivery of
an object or process in enough detail that another party can reconstruct it.
Summary
Subject Treatment
In technical writing, feelings and thoughts of writer mustNOTbe included.
Scope of Document
Needs Of Reader
Writer must understand the needs of reader he is writing document for. For example,
Writer must tell the reader, this is our product, you need this product because....... and it
will be very much beneficial to you because of ........ etc.
summary
Organize Document
Technical document must be well organized. ItMUSThave a proper opening, body and
conclusion.
Identification of Audience
it is the most important part of writing a technical document. You must identify the
audience you are talking to.
Concise
summary
No plagiarism:
A good technical document gives proper attribution when the work of others
make a point or provide background information.
is cited to
Acronyms:
One of the most notable and easy ways to ease the understanding of a
technical document is to limit or eliminate the use of acronyms
Understandable Statistics:
Statistics are becoming a more prominent part of corporate life .
by the