 Experts- These are the people who know the theory and the product inside and out.  Technicians-These are the people who build, operate, maintain, and.

Slides:



Advertisements
Similar presentations
Create Your Own Instruction Manual. Objectives Create an instruction manual, step-by-step guide to perform a task or project. Create an instruction manual,
Advertisements

Report Writing for Business Students. Business School Report Writing Topics 1.Planning 2.Structure & Content 3.Style.
Language Department, Office of General Education, Faculty of Hospitality Industry For Excellence in Hospitality Education Arj. Zeph Norrish Principles.
M. Reber © 5/1/2015 Document Development Cycle Creating Your User’s Guide Step-by-Step.
PARRT THREE: Processes and Guidelines in Technical Writing.
Writing User-Friendly Instructions. You’ll have 4 sets of readings World Wide Web site (click here for access)World Wide Web site an instruction checklist.
Document Design Customized & Workplace Training AAI/Portland Community College Facilitated by George Knox.
IMS Systems Analysis and Design Communication and Documentation: Additional Notes on Written Reports.
Technical Writing II Acknowledgement: –This lecture notes are based on many on-line documents. –I would like to thank these authors who make the documents.
Writing Reports: Identify these stages I) Obtaining a clear specification II) Research & preparation III) Report writing.
Writing Instructions From Online Technical Writing: Task Analysis and Task-Oriented Documentation,
CSE Information Systems 1 Communication and Documentation: Additional Notes on Written Reports.
Audience Analysis & User- Centered Writing Week 2 Technical Communication, DAHMEN.
Types of Audience Executives Experts Technicians Operators
Audience Analysis Dr. Shelley Thomas ENGL Overview Benefits of Audience Analysis Goals of Audience Analysis Types of Readers.
Principles of Communication
The Writing Process. The writing process takes you from the very beginning of a writing project It includes finding topics and analysing audience and.
How to Improve Reading Comprehension. The purpose of reading is to connect the ideas on the page to what you already know.
This Lesson Introduction to the ADDIE model Needs Analysis
© M. Reber 9/6/2015 Instructions Writing Step-By-Step Procedures.
1 Business Writing in a Technical Environment Prepared by Graham Associates copyright 2002 copyright © 2002.
NOTES TO ANDERSON, CHAPTER 8 PROFESSIONAL WRITING.
Helpdesk video  bhtRU bhtRU.
Document and Web design has five goals:
Other types of communicating science, besides scientific papers Malmfors et al chapter 4 Same readers – different aim or form Other readers – still communicating.
TECHNICAL WRITING October 31 st, With a partner Write simple “step-by-step” instructions for sending a Kakao Talk message with a phone.
Chapter Four Achieving a Readable Style. Basic Principles of Effective Style Determine your reader’s knowledge of the subject. Determine if a particular.
Technical Writing A very brief overview.  Establishing an audience and purpose  Designing an effective document  Writing a successful  Achieving.
Chapter 7. Designing Documents and Web Sites © 2013 by Bedford/St. Martin's1 Document and Web design has five goals: to make a good impression on readers.
Getting the Language Right ITSW 1410 Presentation Media Software Instructor: Glenda H. Easter.
Organizing Your Information
Preparing Written and Oral Reports Effective Communication in CH402.
Text Adaptations for ELLs: YES! You Can! By Tim McKay ESL Curriculum Supervisor Pittsburgh Public Schools.
Process Explanations Dr. Lam TECM Let’s Review Week 1: Design What did we learn? Week 2: Comparative analysis What did we learn?
Audience Recognition and Involvement
Audience Analysis TCO 341 Fall 2002 Dr. Codone. Audience Analysis Identifying primary & secondary audiences Identifying primary & secondary audiences.
Page Design and Elements
Chapter 5 Analyzing Your Audience and Purpose. Three steps in analyzing an audience: 1. Identify primary and secondary audiences. 2. Identify basic categories.
Writing and Editing Modular Documentation: Some Best Practices Yoel Strimling (Comverse) Based on a joint presentation with Michelle Corbin (IBM) at the.
EFFECTIVE WRITING 8 Readability. Writing - time and resource consuming, stressful process Texts have a strong tendency of using more complex, more sophisticated.
Call to Write, Third edition Chapter Two, Reading for Academic Purposes: Analyzing the Rhetorical Situation.
William Sanborn Pfeiffer Kaye Adkins
Page Design and Elements TECO 63 M. Reber Page Design Helps readers understand information Indicates hierarchy of ideas and concepts Helps readers.
Improving Readability with Style and Design
Writing Informative Grades College and Career Readiness Standards for Writing Text Types and Purposes arguments 1.Write arguments to support a substantive.
Processes and Guidelines Writing Process: from Audience to Rough Draft: 1.Finding a Topic 2.Analyzing audience and purpose 3.Narrowing down your topic.
Managing Text Flow Lesson 5. Setting Page Layout The layout of a page helps communicate your message. Although the content of your document is obviously.
Document Review for Reviewers and Writers. Topics Readability Document Review Structured Reading.
Processes and Guidelines in Technical Writing Part (2)
Graphics Navigation Usability Typography Content Clarity & Consistency.
Copyright © 2015 McGraw-Hill Education. All rights reserved. No reproduction or distribution without the prior written consent of McGraw-Hill Education.
Principles of Communication Chapter 5: Public Speaking W.I.I.F.M?
September 1,  Analyzing  Choosing and Arranging  Drafting and Revising  Editing.
 Be prepared  Appearance is important, dress appropriately  Knowing your information and being an expert are two different things.
ICAD3218A Create User Documentation.  Before starting to create any user documentation ask ‘What is the documentation going to be used for?’.  When.
Defining Text Features. Unit Title  Reviewing the unit titles can be helpful in giving the “big picture” of the topic.
MANAGING TEXT FLOW Lesson 5. OBJECTIVES SOFTWARE ORIENTATION The Page Layout tab contains groups of commands that will produce a formatted document’s.
Page Design and Elements
Document Development Cycle
Document Development Cycle
HUM 102 Report Writing Skills
Advanced Technical writing
Research, Writing and Presentation Task
Analyzing Your Audience
Giving instructions on how to do something
Easy-to-Read: access to information, effective communication
A CASUAL CONTRIBUTOR’S LEARNING AID FOR DITA STRUCTURING
PROCESS DESCRIPTIONS INSTRUCTIONS
Outline Do not start an outline until your video is approved.
Audience Analysis.
Presentation transcript:

 Experts- These are the people who know the theory and the product inside and out.  Technicians-These are the people who build, operate, maintain, and repair the stuff that the experts design and theorize about.  Executives-These are the people who make business, economic, administrative, legal, governmental, political decisions on the stuff that the experts and technicians work with.  Non-specialists-They want to use the new product to accomplish their tasks; they want to understand the new power technology enough to know whether to vote for or against it in the upcoming bond election.

 Background-knowledge, experience, training- One of your most important concerns is just how much knowledge, experience, or training you can expect in your readers.  Needs and interests-To plan your document, you need to know what your audience is going to expect from that document.  Other demographic characteristics-age groups, type of residence, area of residence, sex, political preferences, and so on.

 More than one audience- You're likely to find that your report is for more than one audience. For example, it may be seen by technical people (experts and technicians) and administrative people (executives).  Wide variability in an audience-You may realize that, although you have an audience that fits into only one category, there is a wide variability in its background.

The following "controls" have mostly to do with making technical information more understandable for nonspecialist audiences:

 Add information readers need to understand your document- for example, a critical series of steps from a set of instructions; important background that helps beginners understand the main discussion; definition of key terms.  Omit information your readers do not need-For example, you can probably chop theoretical discussion from basic instructions.  Change the level of the information you currently have-You may have the right information but it may be "pitched" at too high or too low a technical level.

 Add examples to help readers understand- Examples are one of the most powerful ways to connect with audiences, particularly in instructions.  Change the level of your examples-You may be using examples but the technical content or level may not be appropriate to your readers.  Change the organization of your information-for example, in instructions it's sometimes better to feed in chunks of background at the points where they are immediately needed.

 Strengthen transitions- You can make these connections much clearer by adding transition words and by echoing key words more accurately  Write stronger introductions—both for the whole document and for major sections- People seem to read with more confidence and understanding when they have the "big picture"—a view of what's coming, and how it relates to what they've just read.  Create topic sentences for paragraphs and paragraph groups- It can help readers immensely to give them an idea of the topic and purpose of a section (a group of paragraphs) and in particular to give them an overview of the subtopics about to be covered.

 Change sentence style and length-In instructions, for example, using imperative voice and "you" phrasing is vastly more understandable than the passive voice or third-personal phrasing.  Work on sentence clarity and economy-Often, writing style can be so wordy that it is hard or frustrating to read.  Use more or different graphics-For nonspecialist audiences, you may want to use more graphics— and simpler ones at that.

 Break text up or consolidate text into meaningful, usable chunks- For nonspecialist readers, you may need to have shorter paragraphs.  Add cross-references to important information-In technical information, you can help nonspecialist readers by pointing them to background sources.  Use headings and lists-Readers can be intimidated by big dense paragraphs of writing, uncut by anything other than a blank line now and then.  Use special typography, and work with margins, line length, line spacing, type size, and type style.-Certain type styles are believed to be friendlier and more readable than others.