28
Introduction to Introduction to Technical and Business Technical and Business Writing Writing

Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Embed Size (px)

Citation preview

Page 1: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Introduction to Technical Introduction to Technical and Business Writingand Business Writing

Introduction to Technical Introduction to Technical and Business Writingand Business Writing

Page 2: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

2

What is Technical Writing?

Taking complicated subject matter and transforming it into easy-to-understand information for the reader.

Page 3: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

3

Why do we need technical communication?

• Technical communication serves as a link between the theoretical and the practical world

• There is a need for transforming complex information into something understandable

• Technical communicators serve as mediators between engineers and end-users

Page 4: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

4

How Writing Makes a Difference ?• Writing ability is often correlated with a

superior manager’s characteristics.

• The quality of communication has a strong impact on an idea’s reception.

• Poor proposals and reports mean little or no future with clients.

• Young engineers who write with clarity and make logical presentations tend to become supervisors faster than other engineers.

Page 5: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

5

Writing Cycles

Student Instructor

Engineer Supervisor Manager

TopManagement

ResearcherJournaleditor Publication

Referee

Referee

Student

Workplace

Academics

Page 6: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Why are you studying Why are you studying this Course?this Course?

Why are you studying Why are you studying this Course?this Course?

Page 7: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

7

EXPECTATIONS OF PROFESSIONAL SKILLS

Expectations (in order of importance)#1 Team work – member, leader #2 Communication skills #3 Subject knowledge #4 Time management

Communication = Writing = Speaking (oral) = Computer = Documentation = Web

Page 8: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

8

COMMUNICATE – WHY?

“I want others to appreciate my work”(supervisor, SRC, prospective examiner, examiner, boss)

“I want to know what others want”(looking for job, post-doc, promotion)

“I want to convince others”(project funding, job seeking)

“I want to sell my idea/product”

“I want to publish a lot of good papers”

Page 9: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

9

Desired Attributes of Job Seekers

The two primary attributes young job

applicants need are

•the ability to interact with other people

•basic writing skills.

Page 10: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

What will we study in What will we study in Technical Writing?Technical Writing?

What will we study in What will we study in Technical Writing?Technical Writing?

Page 11: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

11

• Memos and electronic mail (e-mail)—to set meeting agendas and to ask and answers questions

• Letters—to sell, complain, hire, fire, ask and answer questions, and explain the contents of attachments

• Reports—to report on job-related travel or incidents, to study options and recommend action, to report on the progress of ongoing projects, and to document meeting minutes

• Proposals—to highlight problems, to suggest solutions, and to recommend action

• Brochures—to sell and inform, using six-to eight-panel (back and front) foldouts

Page 12: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

12

• Newsletters—to report on corporate activities to both employees and stakeholders

• Fliers—to sell and inform, using brief, single-sided documents

• Resumes—to help you find a job

• Web sites—to sell and inform, using multi screened, Internet-based, hypertext-linked communication

• User manuals—to explain the steps in a procedure

• Technical descriptions—to explain the parts of a mechanism, tool, piece of equipment, or product (3)

Page 13: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Technical Writing is Technical Writing is done todone to

Technical Writing is Technical Writing is done todone to

Page 14: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

14

• Define and order standard processes• Ensure critical processes are standardized• Simplify complexity• Detail operational necessities• Highlight and describe risk• Structure available knowledge in support of

research• Identify useful content• Assemble parts into whole• Coordinate functionalities

Page 15: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

When Should When Should Technical Writing be Technical Writing be

Done ?Done ?

When Should When Should Technical Writing be Technical Writing be

Done ?Done ?

Page 16: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

16

Page 17: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

17

• If you want your customers to walk away from product failures

• If you want to reduce customer calls to your support desk

• If you want your customers to buy your product

• If you want each version of your product to flow smoothly into an established market

Page 18: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

How can you know How can you know when technical when technical

writing is done well ?writing is done well ?

How can you know How can you know when technical when technical

writing is done well ?writing is done well ?

Page 19: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

19

Page 20: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

How does Technical How does Technical Writing Effect a Writing Effect a Corporation ?Corporation ?

How does Technical How does Technical Writing Effect a Writing Effect a Corporation ?Corporation ?

Page 21: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

21

Value to the Corporation

• Well-written and accurate documentation:– Enhances the customer product experience,

contributing to overall satisfaction

– Part of the customer support strategy, reducing support costs

– Speeds up customer acceptance of products

Page 22: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

22

Cost to the Corporation

Poorly written or inaccurate documentation:– Contributes to customer frustration

with the product and the company

– Projects a negative image of the product

Page 23: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Importance of Importance of Teamwork in Teamwork in

Technical WritingTechnical Writing

Importance of Importance of Teamwork in Teamwork in

Technical WritingTechnical Writing““No one person and no one area can solve No one person and no one area can solve

work related problems”work related problems”

Page 24: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

24

Collaboration advantages

• In business and industry, many technical documents are team written

• Advantages• Diversity of opinions• Checks and Balances• Broad based understanding• Empowerment• Team Building

Page 25: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

25

Strategies for Successful Collaboration

• Develop your team• Choose a team leader• Determine your team goal• Identify the problem• Analyze the problem causes• Determine Potential Improvements• Verify the suggested solutions• Complete the team project

Page 26: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Most of your work in Most of your work in this course will be this course will be

collaborative !collaborative !

Most of your work in Most of your work in this course will be this course will be

collaborative !collaborative !

Page 27: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

Lets ReviseLets ReviseLets ReviseLets Revise

Page 28: Introduction to Technical and Business Writing. 2 What is Technical Writing? Taking complicated subject matter and transforming it into easy-to-understand

28

What we discussed today?

• Introduction to Technical and Business Writing

• Objectives of this course• Course contents• Purpose of Technical Writing• Impact of Technical Writing on a

Corporation• Importance of team work in Technical

Writing