comm 1009 week four 2014

21
Comm. 1009: Week 4 Technical Descriptions

Upload: waysen

Post on 06-Jan-2016

217 views

Category:

Documents


0 download

DESCRIPTION

Chapter 6 Notes John m lannon & don klepp Technical Communication

TRANSCRIPT

Page 1: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 1/21

Comm. 1009: Week 4

Technical Descriptions

Page 2: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 2/21

2

Week 4 – Components of Technical

Descriptions

 –  Expanded definition/ clarifier review

 –  What, where, why?

 –  Classifying and partitioning

 –  Writing a technical description

 –  Types and elements of Process

Descriptions

Page 3: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 3/21

3

EXPANDED DEFINITIONS (Review)

 –  A brief form of technical description

 –  Formal definition plus 3 or more clarifiers

• analogy

• etymology

• principal of operation

•illustration

• Etc. (See Ch. 5 in course text)

Page 4: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 4/21

4

Analogy

 –  Compares the unfamiliar to the familiar to identifymajor characteristics.

 –  Examples:

A civet cat is a raccoon-like omnivorousmammal of Mexico and the

southwestern United States having a

long bushy tail with black and white

rings.

A kumquat is a citrus fruit about the size

and shape of a pecan.

Page 5: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 5/21

5

Etymology

 –  The linguistic origin of the word may help

clarify its definition.

 – 

Example:

“The term, ‘solenoid’ is derived from the

Greek word, solenoeides, which means

‘channel’ or ‘shaped like a pipe’.”

Page 6: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 6/21

6

Illustration

 –  Drawings, photographs or diagrams

 –  Introduced by an identifying sentence before

 –  Discussed after their use

1977 BMW R100 RS:

the world’s first full

fairing production

motorcycle.

 –  Descriptive labels

and captions

 –  Positioned carefully

Page 7: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 7/21

7

Choose the right illustrations

 –  Visual overviews:• photographs, realistic drawings, maps

 –  Interior components:• show how parts fit together• Phantom views, schematics, cross-section

maps

 –  Individual parts in relation to the whole:• exploded views, cutaway views.

Page 8: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 8/21

8

To support easy and quick

comprehension

Page 9: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 9/21

9

13 Types of Data Illustrations

1. Tables

2. Bar charts/graphs

3. Pictographs

4. Line charts/graphs

5. Pie charts

Page 10: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 10/21

10

13 Types of Graphics

6. Photographs

7. Drawings/Illustrations8. Screen shots

Page 11: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 11/21

11

13 Types of Graphics

Diagrams can be very effective for instructions

Page 12: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 12/21

12

Use the PFDs and P & IDs to explain a process orsystem

9.Flow charts

10.Diagrams

13 Types of Graphics

Page 13: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 13/21

13

TECHNICAL DESCRIPTIONS

• Any info product that describes something

with a mechanical or scientific focus.

• Explains an item or topic to someone who

wants to understand, buy, use, operate, orassemble it.

• Can include specifications, graphics with words

and/or diagrams, prose (text in paragraphs) orbullet point details.

• Design according to audience and purpose.

Page 14: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 14/21

14

Where are technical

descriptions used?

• Observation notes

• Reference manuals and training materials

• Proposals and reports

• Marketing and promotional pieces

• Public information and education.

Page 15: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 15/21

15

Why do we use technical

descriptions?

• To show how something is put together andwhy it works.

• More specifically:

 –  What is it? What does it do?

 –  What is its purpose and importance?

 –  What are its characteristics?

 –  What are its parts?

 –  How do the parts fit together and worktogether?

Page 16: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 16/21

16

Using partition and

classification

• When describing a single item, partition it into its

component parts.

• When describing a collection of items, classify  them

into smaller groups.

• In technical descriptions, we use both techniques

and delineating the boundaries can be difficult and

even *arbitrary.

Page 17: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 17/21

17

Effective Classifications

 –  Inclusive − Every item has a place, all

items belonging to group are included

 – 

 Exclusive −

 Every item has only oneplace, items not belonging to group are

excluded

 –  Informative − Groupings are useful to

readers.

Page 18: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 18/21

18

Effective Partitions

 –  Inclusive – every part is included

 –  Exclusive – parts that do not belong to

the product or mechanism being

partitioned are excluded

 –  Informative  – groupings useful to

readers.

Page 19: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 19/21

19

Considering Purpose

• If purpose is descriptive:

 –  Focus on structural  components – physical

aspects of the device, without regard to

purpose.

• If purpose is to explain or discuss:

 –  Focus on functional  components – perform

clearly defined tasks in the operation of thedevice.

Page 20: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 20/21

20

Using the clearest descriptive

sequence

 –  Spatial sequence – The way it appears

as a static object

 –  Functional sequence – The way itsparts operate in order

 –  Chronological sequence – The way its

parts are assembled.

Page 21: Comm 1009 Week Four 2014

7/17/2019 Comm 1009 Week Four 2014

http://slidepdf.com/reader/full/comm-1009-week-four-2014 21/21

21

Other Elements

• Distinguish between major and minor parts

 –  Major parts are large and essential

 –  Minor or sub-parts offer detail on minor

parts• Use precise diction so that information is

verifiable

• Use illustrations where useful:

 –  Visual overviews in Introduction

 –  Component views in Body.