Technically Write

121
Technicall Technicall y Write y Write with Alistair King Welcome to

description

-

Transcript of Technically Write

Page 1: Technically Write

Technically Technically WriteWrite

with Alistair King

Welcome to

Page 2: Technically Write

Spoken vs Written

Spoken Language Written Languageis

impermanentis

permanent

and negotiable

and non-negotiable

Page 3: Technically Write

Note that Written Note that Written Language and Spoken Language and Spoken

Language have different Language have different structures.structures.

Spoken Spoken LanguageLanguage

Page 4: Technically Write

EvaluationNew machines

Old machines

New product

Company

Demand

Page 5: Technically Write

TopicWhat is the document

about?

Page 6: Technically Write

Revised Maintenance Procedures

We refer to the above.We refer to the above subject.We refer to the above-mentioned subject.

Topic

Page 7: Technically Write

This report describes the revised maintenance procedures, initiated in March, 2009 and assesses their impact on production capacity.

Topic Sentence:

A topic sentenceA topic sentence¤ expands or extends the title.¤ Identifies, introduces or summarizes the topic.

Topic

Page 8: Technically Write

Final Particulars of Extension of Final Particulars of Extension of Time for CompletionTime for Completion

In accordance with the Clause _______, of the Conditions of Contract,we enclose the final details in respect of the event referred to in our notification / letter of _______ .

Page 9: Technically Write

We write to inform you that the progress of We write to inform you that the progress of the Works has been suspended by reason of the Works has been suspended by reason of

climatic conditions on the Site …climatic conditions on the Site …

Suspension of the Works due to Suspension of the Works due to Climatic Conditions on the Site Climatic Conditions on the Site

Page 10: Technically Write
Page 11: Technically Write

Read this paragraph and devise a title and a topic sentence.

The globalization trend is moving programming jobs from Europe and the US to low-labour countries such as China or India. This appears to place computer science research and departments at risk of being considered as working on obsolete technologyHowever, the opposite is true. Computer science is on the verge of a new generation of computing that is leading to innovation not only in computing but also in business, science, and all other endeavours that depend on computing. It could be that this very volatile situation with regard to the l;abour market is of benefit to the industry.

Computer science appears to be in a period of Computer science appears to be in a period of crisis.crisis.

Page 12: Technically Write
Page 13: Technically Write

Topicestablish the topicmaintain the topic

Page 14: Technically Write

Washing clothesWashing clothes is simple. is simple. First, arrange the First, arrange the clothesclothes into groups according to into groups according to their colours. In some their colours. In some cases, you may find that one cases, you may find that one group is sufficient. If you group is sufficient. If you lack a lack a washing machinewashing machine, you , you may have to take the may have to take the clothesclothes to a to a laundrylaundry. It is . It is important not to important not to washwash too too many many clothesclothes at one time at one time because faults in the because faults in the washing machinewashing machine may may occur. occur. Washing machineWashing machine repairs are often expensive repairs are often expensive and time-consuming. …and time-consuming. … 1/2

Page 15: Technically Write

Washing ClothesAt first, At first, washing clotheswashing clothes may appear may appear complicated; soon however, it will become complicated; soon however, it will become part of life. It is difficult to imagine part of life. It is difficult to imagine dispensing with the need for dispensing with the need for washing washing clothesclothes, but, in the future, it may be , but, in the future, it may be possible. After you have completed possible. After you have completed washing the clotheswashing the clothes, arrange the , arrange the clothesclothes into groups according to who owns them into groups according to who owns them and place them in their respective and place them in their respective cupboardscupboards. In due course, they will be . In due course, they will be removed and removed and wornworn again and then the cycle again and then the cycle of of washing clotheswashing clothes will be repeated. will be repeated. 2/2

Page 16: Technically Write
Page 17: Technically Write

PatientPatientActionActionAgentAgent

The cleanerThe cleaner cleanscleans the floorthe floor

A policemanA policeman is going to arrestis going to arrest that manthat man

SomebodySomebody has stolenhas stolen my walletmy wallet

unimportantunimportant

unnecessaryunnecessary

unknownunknown

Page 18: Technically Write

The Passive Version:(focus on the patient)

The floor is cleaned.

Page 19: Technically Write

The Passive Version:(focus on the patient)

That man is going to be arrested.

Page 20: Technically Write

The Passive Version:(focus on the patient)

My wallet has been stolen.

Page 21: Technically Write

Passive FormsPassive FormsPatientPatient(receives the action)(receives the action)

““to be”to be”(tense and mood)(tense and mood)

Past ParticiplePast Participle(action)(action)

The systemThe systemThe machineThe machineThe houseThe houseThe windowThe windowThe supplierThe supplierThe lensThe lens

isisarearewaswaswerewerehas beenhas beenhad beenhad beenwill bewill bemust bemust becould becould be

installedinstalledrepairedrepairedbuiltbuiltstolenstolencleanedcleanedcontactedcontactedbrokenbrokenupdatedupdated

Page 22: Technically Write
Page 23: Technically Write

Active or Passive?• A thorough investigation has been

conducted and the causes have been identified.

• We have conducted a thorough investigation and we have identified the causes.

Page 24: Technically Write

Active or Passive?

The technicians have identified the following faults: • Technicians• Technicians• Technicians• Technicians

The following faults have been identified:• Faults• Faults• Faults• Faults• Faults

Page 25: Technically Write

• The Contractor shall take every reasonable precaution to protect any section of the Works …

• Every reasonable precaution shall be taken by the Contractor to protect any section of the Works …

• The Contractor shall give the Engineer, in writing, twenty-one days notice of the date …

• The Engineer shall be given, in writing by the Contractor, twenty-one days

notice of the date …

Page 26: Technically Write

First we subjected the blintzer coils to the Hinzlefetzer stress test. Then we measured the stress effects in bluto units. We found an unusually low aggregation of blutomin in the coil material. Then we initiated another round of tests. Finally, we placed a telephone order for pizza and diet Coke.

Page 27: Technically Write

Passive: Passive: The form must be signed by the employee to The form must be signed by the employee to authorize release of physician information to the authorize release of physician information to the insurance company. insurance company. Active: Active: The employee must sign the form to authorize The employee must sign the form to authorize release of physician information to the insurance release of physician information to the insurance companycompany.

Page 28: Technically Write

Passive: Passive: It should be noted that any change to the It should be noted that any change to the procedure must be recorded in the master procedure must be recorded in the master file. file. Active/ Imperative: Active/ Imperative: Note: When you change the procedure, Note: When you change the procedure, record the change in the master file. record the change in the master file.

Page 29: Technically Write

Passive:Passive:Static-sensitive components are Static-sensitive components are stored in protective enclosures. stored in protective enclosures. Active/ Imperative: Active/ Imperative: Store static-sensitive components Store static-sensitive components in protective enclosures. in protective enclosures.

Page 30: Technically Write

Grammatical Differences

Description

Explanation

Instruction

WHAT?

WHY?

HOW?

Page 31: Technically Write

Constructing a Solar Still

About 1 MetrePan to collect water

Water will collect on underside of plastic

sheet

Plastic Sheet

Stones to weigh down sheet

Smooth Stone

1 Metre

Page 32: Technically Write

B r e a kfor

Lunch

Page 33: Technically Write

LanguageLanguage

??

Page 34: Technically Write

The basic message transmitted from the The basic message transmitted from the speaker/writer to the listener/readerspeaker/writer to the listener/reader

Two Aspects of Communication

TTransactionalransactional

Page 35: Technically Write

Please settle your bill by … otherwise we shall have to resort to legal action.

Pay now or we’ll take you to court!

Kindly be advised that failure to effect immediate payment will inevitably

lead to the commencement of legal action.

Page 36: Technically Write

Please give this your utmost priority.Please give this your utmost priority.

I want it and I want it NOW! I want it and I want it NOW!

I wonder if I could possibly ask you if you might …

Page 37: Technically Write

The basic message transmitted from the The basic message transmitted from the speaker/writer to the listener/readerspeaker/writer to the listener/reader

Two Aspects of Communication

TTransactionalransactional

The reaction elicited by the way in which The reaction elicited by the way in which the message is presentedthe message is presented

IInteractionalnteractional

Page 38: Technically Write

Transactional - Interactional

Transactional language is used to convey "factual or propositional information" and has the primary purpose of "the efficient transference of information". Interactional language, by contrast, is used to establish and maintain social relationships.

Discourse Analysis Brown, G and Yule,G (1983)

Page 39: Technically Write

Sit Down !Kindly assume a seated position.Would you mind sitting down ?

Please take a seat.Would you like to take a seat ?

Effective Effective communiccommunic

ation is ation is about about

making making the right the right choiceschoices

Do you:Do you:demanddemand or or requestrequest??

rejectreject or or declinedecline??

complaincomplain or or highlighthighlight??

Page 40: Technically Write

Transactional + Interactional

= Effective CommunicationCertain features of some business documents militate against Effective Communication:

VERBOSITYVERBOSITY

CIRCUMLOCUTIONCIRCUMLOCUTION

TAUTOLOGYTAUTOLOGY

Page 41: Technically Write

We hereby wish to inform of the We hereby wish to inform of the following alterations to the schedule.following alterations to the schedule.

OR …

Please note the following alterations to the schedule.

VerboseVerboseUngrammaticalUngrammatical

Page 42: Technically Write

OR …

We are enclosing a copy of the report which you requested.

As per your valued recent request, enclosed herewith please find a copy of the above-mentioned report for your kind perusal and necessary action.

VerboseVerboseArchaicArchaic

TautologousTautologous

Page 43: Technically Write

Kindly be advised of our revised Kindly be advised of our revised operating procedure, as noted below:operating procedure, as noted below:

Or …

Please note our revised operating procedure:

VerboseVerboseImpersonalImpersonal

Page 44: Technically Write

The teleconversation this morning with The teleconversation this morning with your goodself refers your goodself refers ……

OR …

As I/you/we suggested/clarified/requested/agreed/decided/highlighted on the telephone this morning, …

VerboseVerboseArchaicArchaic

Unfocused Unfocused

Page 45: Technically Write

In the event of any enquiries, please do In the event of any enquiries, please do not hesitate to contact the undersigned.not hesitate to contact the undersigned.

OR

Please contact me/us if you have any enquiries.

VerboseVerboseCircumlocutiousCircumlocutious

ImpersonalImpersonal

Page 46: Technically Write

We would appreciate it, if you could We would appreciate it, if you could attend to the above-mentioned matter attend to the above-mentioned matter at your earliest possible convenience.at your earliest possible convenience.

Or …

We would appreciate your prompt attention to this matter.

VerboseVerboseCircumlocutiousCircumlocutious

Page 47: Technically Write

Dear Valued Customer,

We look forward to your favourable reply.XX

We refer to the above.We refer to the above.XX

XX

Page 48: Technically Write

The five ‘C’sCLEAR: The document can be

understood on the first reading.CONCISE: The document is down to an

intelligent and intelligible minimum.COMPLETE: All necessary material has

been included.CORRECT: The document is accurately

written and the points verifiable.COURTEOUS: The document treats the

reader with respect.

CommunicativeCommunicative

Page 49: Technically Write

[email protected]@aksb.com.my

Page 50: Technically Write

aa TENSE TENSE afternafternoon!oon!

Page 51: Technically Write

We have accepted the invitation to the We have accepted the invitation to the function.function.

We accepted the invitation on 25We accepted the invitation on 25thth January. January.

They cancelled the function on 26They cancelled the function on 26thth January. January.

We had accepted the invitation to the We had accepted the invitation to the function when they cancelled the function.function when they cancelled the function.

Present PerfectPresent Perfect

Simple PastSimple Past

Simple PastSimple Past

Past PerfectPast Perfect

Simple PastSimple Past

Page 52: Technically Write
Page 53: Technically Write

The bridge collapsed because it rained

heavily.

Page 54: Technically Write

The bridge collapsed because it rained heavily.

Page 55: Technically Write

The bridge collapsed because it had rained

heavily.

The bridge collapsed because it rained

heavily.

Page 56: Technically Write

The student failed his The student failed his exam because he played exam because he played football the whole time.football the whole time.

The student failed his exam becauseThe student failed his exam because he HAD played football the whole time.he HAD played football the whole time.

Page 57: Technically Write

He sustained an electric shock

because he had touched the live

wire.

XX

Page 58: Technically Write
Page 59: Technically Write

SIMPLE PAST NOW

PRESENT PERFECT

PRESENT

PERFECT

PAST PERFECT

Time Line

Page 60: Technically Write

1989SIMPLE PAST

2013NOW

“Since 1989, I have visited Los Angeles.”

“In / By 1989, I had visited Los Angeles.”

Time Line

“I have visited Los Angeles.”

“I visited Los Angeles in 1989.”

Page 61: Technically Write

Iwamatsu Ltd.Iwamatsu Limited ____________ (establish) in 1935 to

manufacture machine tools and mining equipment. In 1985, the company ____________ (expand) its production to include farm tractors. Since then, Iwamatsu _____________ (develop) a wide range of sophisticated mining equipment. The workforce ___________ (grow) to its current strength of 15,600 worldwide. In 1995, it __________ (rank) No.4 in the world in the production of construction equipment.

In the last fifteen years, sales __________ (increase) by an average of 14% annually. Sales in 1995 __________ (total) 583 billion Yen, which was a jump of 21% over the previous year.

Since 1965, the company _____________ (receive) the prestigious Bentley Prize for quality control no fewer than seven times.

was established

expanded

has developed

has grownranked

have increasedtotalled

has received

Page 62: Technically Write

AC200In 2001, the AC200 ____________ (introduce) onto

the market to replace AC100, which ___________ (become) unable to cope with the increased workload of many users. In 2001, the sustainable market life of the AC200 ___________ (expect) to be five years. However, sales ___________ (surpass) expectations. Indeed, in the last twelve months sales ___________ (show) an increase of 12%.

In order to capitalise on the success of the AC200, a modified version, the AC200e, _____________ (develop) and ___________ (launch) before the end of this year.

was introducedhad become

was expectedhave surpassed

have shown

has been developedwill be launched

Page 63: Technically Write

Dear ……. Super-Sealer Concrete We would like to draw your attention to Super-Sealer Concrete, which [1]__________ (arrive) on the Malaysian market within the last month. Yesterday morning, we [2]__________ (meet) with representatives of Maxwell Mixwell Cement Sdn Bhd, the company which has the sole distribution rights for this product in Malaysia. The MMC representatives [3]________ (show) us samples of this product before and after mixing and [4]__________ (provide) us with ingredient specifications, a copy of which we are enclosing.

has arrived

met

showedprovided

Page 64: Technically Write

Super-Sealer Concrete contains the water-resistant substance Impervion, which [5]_____________ (be developed) by Swedish scientists in 2002. Since then, Impervion [6]_____________ (be used) in a variety of construction projects with flat concrete roofs, for example, the 35-storey Political Prisoner Rehabilitation Centre in Yangon and the shark-shaped New Sydney Opera House. Super-Sealer Concrete comes with a 25-year warranty against leaks.

was developed

has been used

Page 65: Technically Write

When we [7]__________ (present) our proposal with estimate of cost to you in October, Super-Sealer Concrete [8]______________ (not become) available in Malaysia. However, we now feel that this concrete would be of great benefit if used in the concrete roofing slabs for both the main office block and the adjacent car park. This would incur an additional cost to you of approximately RM70,000. Please let us know if you agree to this in principle and we will provide you with a new, detailed estimate to reflect the additional cost. Yours sincerely

presented

had not become

Page 66: Technically Write

1. installed; have encountered2. noticed; had cracked3. switched; came4. bought; has serviced5. began; had used6. reported; had seen7. cost; have risen8. occurred; had forgotten9. took; have not repaired10.have replaced; replaced

Page 67: Technically Write

`

BreBreakak

Page 68: Technically Write

* * WelcomWelcom

ee * *Day 2

Page 69: Technically Write

It was raining and I opened my umbrella.

and

It was raining so I opened my umbrella.

Page 70: Technically Write

RelativesRelatives

QualificationsQualifications

AnticipationsAnticipations

Linking Devices

COHESION

Page 71: Technically Write
Page 72: Technically Write

BecauseBecause Windows was not shut down properly,one or more of your drives may have errors on it.

Exit

100%

Microsoft Scandisk

Page 73: Technically Write

Relatives

1. Tin, which is one of Malaysia’s most important natural resources, is exported to many countries.2. Tin, which is exported to many countries, is one of Malaysia’s

most important natural resources.

Principal Clause

Subordinate Clause

Tin is exported to many countries.

Relative Clause Tin is one of Malaysia’s most important natural resources.

which

Page 74: Technically Write

E

P S R

E = Clause

P = PrincipalS = Subordinate

R = Relative

Clause

Page 75: Technically Write

Relatives

Tin, which is one of Malaysia’s most important natural resources, is exported to many countries.

Tin, which is exported to many countries, is one of Malaysia’s most important natural resources.

1.

Page 76: Technically Write

Relatives

Tin is mined in Perak, which is one of Malaysia’s richest states.

Perak, where tin is mined, is one of Malaysia’s richest states.

2.

Page 77: Technically Write

Relatives

The price of tin is heavily dependent on world demand, which has fluctuated considerably in recent years.

World demand, on which the price of tin is heavily dependent, has fluctuated considerably in recent years.

3.

Page 78: Technically Write

Relatives

These fluctuations have seriously affected some tin producers, who have gone out of business.

Some tin producers, whom these fluctuations have seriously affected, have gone out of business.

4.

Page 79: Technically Write

Relatives

Many tin workers, whose tin mines have been closed, have had to look for other work.

5.

Page 80: Technically Write

Relatives

Place the relative pronoun next to what it refers to.

Place the principal information in the principal clause.

Page 82: Technically Write
Page 83: Technically Write

What is the capital of France ?

“Paris”or

“Paris which stands on the River Seine”

““Capital of France ?”Capital of France ?”

Page 84: Technically Write
Page 85: Technically Write

Project Feasibility ProjectProject Feasibility Project

Page 86: Technically Write

Grammatical ParallelismGrammatical Parallelism

 

Grammatical Parallelism is a term Grammatical Parallelism is a term which indicates that all of the which indicates that all of the items in a list should share the items in a list should share the same grammatical feature.same grammatical feature.

Page 87: Technically Write

Observe Observe Grammatical Grammatical ParallelismParallelism

• Turn the screw anti-clockwise to loosen.Turn the screw anti-clockwise to loosen.• Pull the red-coated wire out from the clamp.Pull the red-coated wire out from the clamp.• Repeat the same procedure for the black-coated wire.Repeat the same procedure for the black-coated wire.

OROR• The screw must be turned anti-clockwise to loosen.The screw must be turned anti-clockwise to loosen.• The red-coated wire must be pulled out from the clamp.The red-coated wire must be pulled out from the clamp.• The same procedure must be repeated for the black-coated wire.The same procedure must be repeated for the black-coated wire.

Red lever - place in a vertical position 

Page 88: Technically Write

Say what is wrong with this and correct it:

I enjoy playing tennis, swimming and to climb mountains.

 

A.

Page 89: Technically Write

B.Say what is wrong with this and correct it:

Post of Marketing Trainee•         SPM graduate of any discipline•         Good communication and customer

service skills•         Experience is an ADVANTAGE BUT NOT

required•         Possess drive to succeed•         Fresh graduates / school leavers are

encouraged to apply

Page 90: Technically Write

C.Say what is wrong with this and correct it:

• Instructions1.Switch off the mains power supply2.Remove the plug from the wall socket3.Unscrewing of the four nuts marked “A”4.The metal cover must be removed5.Red lever - place in a vertical position

Page 91: Technically Write

Sample 1

• Dismental old unit OB and replace the new unit. After testing, the problem still around.

• Checking and troubleshooting the have relay separation signal having trouble due to supply and relay not enough current to support the coil induction.

• Change the different type relay …• Tested OK, New OB taken back, currently still

using old.

Page 92: Technically Write

Sample 2

•  •  • Troubleshooting intercom ….• Checking and trace cable• Trace jelly …

Page 93: Technically Write

Sample 3

• Send maintenance checklist to …• Collect maintenance checklist … 

Page 94: Technically Write

Sample 4

• Quarter yearly service and maintenance for UPS for the month of June 2011

• Record the battery reading and UPS condition completed

Page 95: Technically Write

• Sample 5• Install 2 units controller …• Setting database for mixed mode …• Testing and commissioning …

Page 96: Technically Write

B r e a kfor

L u n c h

Page 97: Technically Write

WelcomWelcome back!e back!

Page 98: Technically Write
Page 99: Technically Write

Manual of Operations

Accounting software user’s manual

Procedures for manufacturing

Owner’s Operation Manual

Human Resource Policies Manual

Operations Manual for opening a restaurant franchise

Page 100: Technically Write

Manual of Operations

What does it have?

What can it do?

How to do it?

Page 101: Technically Write

Manual of Operations

Sequencing

PrerequisitesPrerequisites InstructionsInstructions WarningsWarnings

PrerequisitesPrerequisites InstructionsInstructionsWarningsWarnings

Page 102: Technically Write

Manual of Operations

Rewiring a table lamp

Page 103: Technically Write
Page 104: Technically Write

LabLab ReportsReports

Lab Lab ReportsReports

Page 105: Technically Write

LabLab ReportsReports• Title PageTitle Page• IntroductioIntroductio

nn• MaterialsMaterials• MethodMethod• DataData• ResultsResults

• AnalysisAnalysis• DeductionDeduction• RecommendationsRecommendations• Figures and Figures and GraphsGraphs• ReferencesReferences

Page 106: Technically Write

Diagnosis

Treatment

Introduction

SymptomsFindings

Conclusions

Recommendations

Components of a Technical Report

Page 107: Technically Write

Diagnosis

Treatment

Introduction

Conclusions

Recommendations

Components of an Executive Summary

Page 108: Technically Write
Page 109: Technically Write

INTERGON INCINTERGON INC

Report on Problems Report on Problems with Machines 3 and 6with Machines 3 and 6

Intergon Inc.

Page 110: Technically Write

Introduction

This report sets out the reasons for the frequent breakdowns on Machine 3 and 6 and identifies the measures to prevent similar recurrences. The problems need to be addressed since there have been hold-ups in production.

Intergon Inc.

Page 111: Technically Write

Machine 3

ConclusionsInadequate internal 1st level supportPoor response time from vendorTraining Issues

Operators are not trained prior to machine installation

Inadequate number of operators are trained

Intergon Inc.

Page 112: Technically Write

Machine 3

ConclusionsNo proper procedures in place

• Machine handling• Quality assurance• Contingency plan for breakdown• Duty schedule

No spare parts kept for emergency breakdown

Intergon Inc.

Page 113: Technically Write

Machine 6

ConclusionsNo regular maintenanceNo safety measures in place

• Workplace• Personnel

Intergon Inc.

Page 114: Technically Write

Recommendations Train Internal technicians to provide 1st level

support Institute training for workforce

• Negotiate training package with vendor• Introduce peer training by supervisors

Revise and enforce maintenance contract to include:• Vendors’ response time• Liability for consequential losses and damages

Formulate Operations Manual

Intergon Inc.

Page 115: Technically Write

Recommendations

Set up quality assurance team Set up Business Continuity and Contingency Plan

to include:• Using other machines as temporary replacement• Requesting other factories in group to despatch stocks

Provide training on first aid and purchase first aid kits

Intergon Inc.

Page 116: Technically Write

Recommendations

Introduce insurance scheme for staff Carry out regular maintenance on machinesIdentify critical machine parts and keep

stocks for contingenciesSet in place a Duty Schedule and allocate

relief staff

Intergon Inc.

Page 117: Technically Write

Recommendation

It is imperative for the Management to look into the conclusions and the recommendations to solve the frequent breakdowns and delay in production.

Intergon Inc.

Page 118: Technically Write

Thank Thank You!You!

All the All the veryvery best!best!

Page 119: Technically Write

Thank Thank You!You!

Page 120: Technically Write

A good report is :

CLEAR(may be understood on the first

reading)CONCISE

COMPLETE

CORRECT

(down to an intelligent and intelligible minimum)

(includes all necessary information)

(accurate and verifiable)

Page 121: Technically Write

All the best in your technical writing!