SlideShare a Scribd company logo
1 of 15
9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 1
Technical Writing basics
Technical Definitions
Ethical considerations
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 2
Tech Writing/Definitions/Ethics
 What is technical writing
 Technical Definitions
 Ref: Finkelstein – Chapters 1, 2, 3
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 3
Technical Writing
 What is technical writing?
 Writing (communication) is an essential skill for
all professionals
 Technical writing is the writing of those involved
in the technical fields, i.e., science and
engineering.
 In science and engineering
 Write technical reports
 Write technical proposals
 Various forms of technical communication
What is technical writing
 For some things it is easier to say what it is
not.
 What type of writing is this?
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 4
It was a dark and stormy night. The wind was howling, the shutters were banging against
the house, the rain was beating down, and a dog howled in the distance. The …..
What is technical writing
 For some things it is easier to say what it is
not.
 What type of writing is this?
 Creative writing – It describes a storm, is
descriptive, but also often evokes emotion.
 Often creative writing is seen as imaginative and
“fun”.
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 5
It was a dark and stormy night. The wind was howling, the shutters were banging against
the house, the rain was beating down, and a dog howled in the distance. The …..
Technical versus creative
 Technical writing lacks the emotional impact
 Technical writing avoids use of rich
metaphors and figures of speech.
 Typically sentence structures are simple and
direct.
 “Technical writing is precise, objective,
direct, and clearly defined.”
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 6
The level of abstraction
 Technical writing describes items precisely, i.e.,
a low level of abstraction
 A 33K ohm, one-watt carbon resistor
 This a low level of abstraction
 The level of abstraction can be varied
 Resistor
 Circuit component
 Electrical Device
 As the level of abstraction increases the level of
precision of detail decreases
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 7
Audience
 Always must consider your audience
 Quality of writing measure – two metrics
 How well the reader understands, precisely, the
intended meaning
 How well the understanding fulfills the intended
purpose
 “THERE IS ALWAYS A SPECIFIC
REQUIREMENT FOR WHAT IS BEING
WRITTEN.”
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 8
Audience and Purpose
 Almost always known
 Typically know who the audience is
 Typically know why you are writing the
document and what the required content is
 Technical writing is usually very visual
 With today’s computer assisted writing, in-
line pictures/figures are expected.
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 9
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 10
Tech Writing/Definitions/Ethics
 What is technical writing
 Technical Definitions
 Ref: Finkelstein – Chapters 1, 2, 3
Technical Definitions
 “In technical writing, definition is the process
by which one assigns a precise meaning to a
term.”
 Term = Classification + Differentation
 Example:
 A stall is a flight condition in which the lift
produced becomes less than the weight of the
airplane, and the airplane stops flying.
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 11
Differentiation
 Stall has meaning based on the context.
 In flying the definition was just given
 In driving, a stall is an operating condition in
which a sudden and unexpected loss of power
occurs.
 In farming, a stall is a single, three-sided
compartment that is designed to shelter and
animal in a barn or stable.
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 12
The audience
 For technical definitions who the audience is
matters
 Consider:
 In water softening, zeolite is an exchange resin that
releases sodium ions while gaining calcium and
magnesium ions.
 In water softening, zeolite is a special material that
releases sodium into the water while absorbing
calcium and magnesium from the water.
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 13
Technical Definition challenges
 Often need further definitions
 To define one term introduce several others
 Circular definition structurre
 One term introduces another and so on until you
are back at the original term
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 14
Technical definition checklist
 On Page 34 of the Text
 All questions here are important
 Two are common mistakes
 Define term using the same term
 Define term using terms that also need definition
 More information on Technical definitions is
contained in the Technical Definition lecture.
9/24/11 - Technical
Writing
Copyright 2011 - Joanne DeGroat, ECE, OSU 15

More Related Content

What's hot

Comparative Study and Performance Analysis of different Modulation Techniques...
Comparative Study and Performance Analysis of different Modulation Techniques...Comparative Study and Performance Analysis of different Modulation Techniques...
Comparative Study and Performance Analysis of different Modulation Techniques...Souvik Das
 
ECS455 - 2 - 4 - Erlang B Formula.pdf
ECS455 - 2 - 4 - Erlang B Formula.pdfECS455 - 2 - 4 - Erlang B Formula.pdf
ECS455 - 2 - 4 - Erlang B Formula.pdfSujanShrestha386167
 
SOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJA
SOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJASOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJA
SOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJAvtunotesbysree
 
L 1 5 sampling quantizing encoding pcm
L 1 5 sampling quantizing encoding pcmL 1 5 sampling quantizing encoding pcm
L 1 5 sampling quantizing encoding pcmDEEPIKA KAMBOJ
 
Version spaces
Version spacesVersion spaces
Version spacesGekkietje
 
Aliasing and Antialiasing filter
Aliasing and Antialiasing filterAliasing and Antialiasing filter
Aliasing and Antialiasing filterSuresh Mohta
 
Simulation of Wireless Communication Systems
Simulation of Wireless Communication SystemsSimulation of Wireless Communication Systems
Simulation of Wireless Communication SystemsBernd-Peter Paris
 
Teletraffic engineering handbook
Teletraffic engineering handbookTeletraffic engineering handbook
Teletraffic engineering handbookDeepak Singh
 
Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)
Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)
Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)NimithaSoman
 
Pulse amplitude modulation & demodulation
Pulse amplitude modulation & demodulationPulse amplitude modulation & demodulation
Pulse amplitude modulation & demodulationVishal kakade
 
Knowledge Engineering in FOL.
Knowledge Engineering in FOL.Knowledge Engineering in FOL.
Knowledge Engineering in FOL.Megha Sharma
 
Data Communication & Computer Networks: Multi level, multi transition & block...
Data Communication & Computer Networks: Multi level, multi transition & block...Data Communication & Computer Networks: Multi level, multi transition & block...
Data Communication & Computer Networks: Multi level, multi transition & block...Dr Rajiv Srivastava
 
introduction to channel borrowing scheme in cellular networks
introduction to channel borrowing scheme in cellular networksintroduction to channel borrowing scheme in cellular networks
introduction to channel borrowing scheme in cellular networksTanmoy Barman
 
Digital Signal Processing Lab Manual ECE students
Digital Signal Processing Lab Manual ECE studentsDigital Signal Processing Lab Manual ECE students
Digital Signal Processing Lab Manual ECE studentsUR11EC098
 

What's hot (20)

Frequency translation
Frequency translationFrequency translation
Frequency translation
 
Digital communication unit 1
Digital communication unit 1Digital communication unit 1
Digital communication unit 1
 
Comparative Study and Performance Analysis of different Modulation Techniques...
Comparative Study and Performance Analysis of different Modulation Techniques...Comparative Study and Performance Analysis of different Modulation Techniques...
Comparative Study and Performance Analysis of different Modulation Techniques...
 
Source coding
Source codingSource coding
Source coding
 
ECS455 - 2 - 4 - Erlang B Formula.pdf
ECS455 - 2 - 4 - Erlang B Formula.pdfECS455 - 2 - 4 - Erlang B Formula.pdf
ECS455 - 2 - 4 - Erlang B Formula.pdf
 
TinyOS
TinyOSTinyOS
TinyOS
 
SOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJA
SOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJASOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJA
SOLUTION MANUAL OF COMMUNICATION NETWORKS BY ALBERTO LEON GARCIA & INDRA WIDJAJA
 
L 1 5 sampling quantizing encoding pcm
L 1 5 sampling quantizing encoding pcmL 1 5 sampling quantizing encoding pcm
L 1 5 sampling quantizing encoding pcm
 
Version spaces
Version spacesVersion spaces
Version spaces
 
Mimo [new]
Mimo [new]Mimo [new]
Mimo [new]
 
Aliasing and Antialiasing filter
Aliasing and Antialiasing filterAliasing and Antialiasing filter
Aliasing and Antialiasing filter
 
Simulation of Wireless Communication Systems
Simulation of Wireless Communication SystemsSimulation of Wireless Communication Systems
Simulation of Wireless Communication Systems
 
Frequency response(1)
Frequency response(1)Frequency response(1)
Frequency response(1)
 
Teletraffic engineering handbook
Teletraffic engineering handbookTeletraffic engineering handbook
Teletraffic engineering handbook
 
Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)
Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)
Ec8491 CT - Unit 1 - Single Sideband Suppressed Carrier (SSB-SC)
 
Pulse amplitude modulation & demodulation
Pulse amplitude modulation & demodulationPulse amplitude modulation & demodulation
Pulse amplitude modulation & demodulation
 
Knowledge Engineering in FOL.
Knowledge Engineering in FOL.Knowledge Engineering in FOL.
Knowledge Engineering in FOL.
 
Data Communication & Computer Networks: Multi level, multi transition & block...
Data Communication & Computer Networks: Multi level, multi transition & block...Data Communication & Computer Networks: Multi level, multi transition & block...
Data Communication & Computer Networks: Multi level, multi transition & block...
 
introduction to channel borrowing scheme in cellular networks
introduction to channel borrowing scheme in cellular networksintroduction to channel borrowing scheme in cellular networks
introduction to channel borrowing scheme in cellular networks
 
Digital Signal Processing Lab Manual ECE students
Digital Signal Processing Lab Manual ECE studentsDigital Signal Processing Lab Manual ECE students
Digital Signal Processing Lab Manual ECE students
 

Viewers also liked

Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02
Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02
Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02Pierre Battah
 
Business ethics
Business ethicsBusiness ethics
Business ethicsSajjad Ali
 
Ethical Leadership Theories
Ethical Leadership TheoriesEthical Leadership Theories
Ethical Leadership Theoriescatsfood
 
Introduction to Technical Writing
Introduction to Technical WritingIntroduction to Technical Writing
Introduction to Technical WritingVince
 
Influence tactics of leaders
Influence tactics of leadersInfluence tactics of leaders
Influence tactics of leadersAbdul Basit
 
Leadership Outline For Presentation
Leadership Outline For PresentationLeadership Outline For Presentation
Leadership Outline For Presentationra41764n
 
Introduction to technical writing
Introduction to technical writingIntroduction to technical writing
Introduction to technical writingAdam Tablante
 
Transactional and transformational leadership(1)
Transactional and transformational leadership(1)Transactional and transformational leadership(1)
Transactional and transformational leadership(1)jjadhav1972
 

Viewers also liked (11)

Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02
Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02
Ethical Leadership Pierre Battah Leadership Inc. 2017-02-02
 
Business ethics
Business ethicsBusiness ethics
Business ethics
 
Ethical Leadership Theories
Ethical Leadership TheoriesEthical Leadership Theories
Ethical Leadership Theories
 
Introduction to Technical Writing
Introduction to Technical WritingIntroduction to Technical Writing
Introduction to Technical Writing
 
Influence tactics of leaders
Influence tactics of leadersInfluence tactics of leaders
Influence tactics of leaders
 
Leadership Outline For Presentation
Leadership Outline For PresentationLeadership Outline For Presentation
Leadership Outline For Presentation
 
Introduction to technical writing
Introduction to technical writingIntroduction to technical writing
Introduction to technical writing
 
Transactional and transformational leadership(1)
Transactional and transformational leadership(1)Transactional and transformational leadership(1)
Transactional and transformational leadership(1)
 
Ethical Leadership
Ethical LeadershipEthical Leadership
Ethical Leadership
 
Technical Writing
Technical WritingTechnical Writing
Technical Writing
 
Organizational culture and ethical behavior
Organizational culture and ethical behaviorOrganizational culture and ethical behavior
Organizational culture and ethical behavior
 

Recently uploaded

Hybridoma Technology ( Production , Purification , and Application )
Hybridoma Technology  ( Production , Purification , and Application  ) Hybridoma Technology  ( Production , Purification , and Application  )
Hybridoma Technology ( Production , Purification , and Application ) Sakshi Ghasle
 
URLs and Routing in the Odoo 17 Website App
URLs and Routing in the Odoo 17 Website AppURLs and Routing in the Odoo 17 Website App
URLs and Routing in the Odoo 17 Website AppCeline George
 
Grant Readiness 101 TechSoup and Remy Consulting
Grant Readiness 101 TechSoup and Remy ConsultingGrant Readiness 101 TechSoup and Remy Consulting
Grant Readiness 101 TechSoup and Remy ConsultingTechSoup
 
Activity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdfActivity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdfciinovamais
 
18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf
18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf
18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdfssuser54595a
 
mini mental status format.docx
mini    mental       status     format.docxmini    mental       status     format.docx
mini mental status format.docxPoojaSen20
 
“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...
“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...
“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...Marc Dusseiller Dusjagr
 
Mastering the Unannounced Regulatory Inspection
Mastering the Unannounced Regulatory InspectionMastering the Unannounced Regulatory Inspection
Mastering the Unannounced Regulatory InspectionSafetyChain Software
 
BASLIQ CURRENT LOOKBOOK LOOKBOOK(1) (1).pdf
BASLIQ CURRENT LOOKBOOK  LOOKBOOK(1) (1).pdfBASLIQ CURRENT LOOKBOOK  LOOKBOOK(1) (1).pdf
BASLIQ CURRENT LOOKBOOK LOOKBOOK(1) (1).pdfSoniaTolstoy
 
Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...
Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...
Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...RKavithamani
 
Beyond the EU: DORA and NIS 2 Directive's Global Impact
Beyond the EU: DORA and NIS 2 Directive's Global ImpactBeyond the EU: DORA and NIS 2 Directive's Global Impact
Beyond the EU: DORA and NIS 2 Directive's Global ImpactPECB
 
Employee wellbeing at the workplace.pptx
Employee wellbeing at the workplace.pptxEmployee wellbeing at the workplace.pptx
Employee wellbeing at the workplace.pptxNirmalaLoungPoorunde1
 
Z Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot GraphZ Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot GraphThiyagu K
 
Interactive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communicationInteractive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communicationnomboosow
 
Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991
Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991
Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991RKavithamani
 
Organic Name Reactions for the students and aspirants of Chemistry12th.pptx
Organic Name Reactions  for the students and aspirants of Chemistry12th.pptxOrganic Name Reactions  for the students and aspirants of Chemistry12th.pptx
Organic Name Reactions for the students and aspirants of Chemistry12th.pptxVS Mahajan Coaching Centre
 
Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17Celine George
 
Arihant handbook biology for class 11 .pdf
Arihant handbook biology for class 11 .pdfArihant handbook biology for class 11 .pdf
Arihant handbook biology for class 11 .pdfchloefrazer622
 

Recently uploaded (20)

Hybridoma Technology ( Production , Purification , and Application )
Hybridoma Technology  ( Production , Purification , and Application  ) Hybridoma Technology  ( Production , Purification , and Application  )
Hybridoma Technology ( Production , Purification , and Application )
 
URLs and Routing in the Odoo 17 Website App
URLs and Routing in the Odoo 17 Website AppURLs and Routing in the Odoo 17 Website App
URLs and Routing in the Odoo 17 Website App
 
Grant Readiness 101 TechSoup and Remy Consulting
Grant Readiness 101 TechSoup and Remy ConsultingGrant Readiness 101 TechSoup and Remy Consulting
Grant Readiness 101 TechSoup and Remy Consulting
 
Activity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdfActivity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdf
 
18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf
18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf
18-04-UA_REPORT_MEDIALITERAСY_INDEX-DM_23-1-final-eng.pdf
 
mini mental status format.docx
mini    mental       status     format.docxmini    mental       status     format.docx
mini mental status format.docx
 
“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...
“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...
“Oh GOSH! Reflecting on Hackteria's Collaborative Practices in a Global Do-It...
 
Mastering the Unannounced Regulatory Inspection
Mastering the Unannounced Regulatory InspectionMastering the Unannounced Regulatory Inspection
Mastering the Unannounced Regulatory Inspection
 
BASLIQ CURRENT LOOKBOOK LOOKBOOK(1) (1).pdf
BASLIQ CURRENT LOOKBOOK  LOOKBOOK(1) (1).pdfBASLIQ CURRENT LOOKBOOK  LOOKBOOK(1) (1).pdf
BASLIQ CURRENT LOOKBOOK LOOKBOOK(1) (1).pdf
 
INDIA QUIZ 2024 RLAC DELHI UNIVERSITY.pptx
INDIA QUIZ 2024 RLAC DELHI UNIVERSITY.pptxINDIA QUIZ 2024 RLAC DELHI UNIVERSITY.pptx
INDIA QUIZ 2024 RLAC DELHI UNIVERSITY.pptx
 
Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...
Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...
Privatization and Disinvestment - Meaning, Objectives, Advantages and Disadva...
 
Beyond the EU: DORA and NIS 2 Directive's Global Impact
Beyond the EU: DORA and NIS 2 Directive's Global ImpactBeyond the EU: DORA and NIS 2 Directive's Global Impact
Beyond the EU: DORA and NIS 2 Directive's Global Impact
 
Employee wellbeing at the workplace.pptx
Employee wellbeing at the workplace.pptxEmployee wellbeing at the workplace.pptx
Employee wellbeing at the workplace.pptx
 
Z Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot GraphZ Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot Graph
 
TataKelola dan KamSiber Kecerdasan Buatan v022.pdf
TataKelola dan KamSiber Kecerdasan Buatan v022.pdfTataKelola dan KamSiber Kecerdasan Buatan v022.pdf
TataKelola dan KamSiber Kecerdasan Buatan v022.pdf
 
Interactive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communicationInteractive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communication
 
Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991
Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991
Industrial Policy - 1948, 1956, 1973, 1977, 1980, 1991
 
Organic Name Reactions for the students and aspirants of Chemistry12th.pptx
Organic Name Reactions  for the students and aspirants of Chemistry12th.pptxOrganic Name Reactions  for the students and aspirants of Chemistry12th.pptx
Organic Name Reactions for the students and aspirants of Chemistry12th.pptx
 
Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17
 
Arihant handbook biology for class 11 .pdf
Arihant handbook biology for class 11 .pdfArihant handbook biology for class 11 .pdf
Arihant handbook biology for class 11 .pdf
 

Lect 4 technical writing basics

  • 1. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 1 Technical Writing basics Technical Definitions Ethical considerations
  • 2. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 2 Tech Writing/Definitions/Ethics  What is technical writing  Technical Definitions  Ref: Finkelstein – Chapters 1, 2, 3
  • 3. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 3 Technical Writing  What is technical writing?  Writing (communication) is an essential skill for all professionals  Technical writing is the writing of those involved in the technical fields, i.e., science and engineering.  In science and engineering  Write technical reports  Write technical proposals  Various forms of technical communication
  • 4. What is technical writing  For some things it is easier to say what it is not.  What type of writing is this? 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 4 It was a dark and stormy night. The wind was howling, the shutters were banging against the house, the rain was beating down, and a dog howled in the distance. The …..
  • 5. What is technical writing  For some things it is easier to say what it is not.  What type of writing is this?  Creative writing – It describes a storm, is descriptive, but also often evokes emotion.  Often creative writing is seen as imaginative and “fun”. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 5 It was a dark and stormy night. The wind was howling, the shutters were banging against the house, the rain was beating down, and a dog howled in the distance. The …..
  • 6. Technical versus creative  Technical writing lacks the emotional impact  Technical writing avoids use of rich metaphors and figures of speech.  Typically sentence structures are simple and direct.  “Technical writing is precise, objective, direct, and clearly defined.” 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 6
  • 7. The level of abstraction  Technical writing describes items precisely, i.e., a low level of abstraction  A 33K ohm, one-watt carbon resistor  This a low level of abstraction  The level of abstraction can be varied  Resistor  Circuit component  Electrical Device  As the level of abstraction increases the level of precision of detail decreases 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 7
  • 8. Audience  Always must consider your audience  Quality of writing measure – two metrics  How well the reader understands, precisely, the intended meaning  How well the understanding fulfills the intended purpose  “THERE IS ALWAYS A SPECIFIC REQUIREMENT FOR WHAT IS BEING WRITTEN.” 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 8
  • 9. Audience and Purpose  Almost always known  Typically know who the audience is  Typically know why you are writing the document and what the required content is  Technical writing is usually very visual  With today’s computer assisted writing, in- line pictures/figures are expected. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 9
  • 10. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 10 Tech Writing/Definitions/Ethics  What is technical writing  Technical Definitions  Ref: Finkelstein – Chapters 1, 2, 3
  • 11. Technical Definitions  “In technical writing, definition is the process by which one assigns a precise meaning to a term.”  Term = Classification + Differentation  Example:  A stall is a flight condition in which the lift produced becomes less than the weight of the airplane, and the airplane stops flying. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 11
  • 12. Differentiation  Stall has meaning based on the context.  In flying the definition was just given  In driving, a stall is an operating condition in which a sudden and unexpected loss of power occurs.  In farming, a stall is a single, three-sided compartment that is designed to shelter and animal in a barn or stable. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 12
  • 13. The audience  For technical definitions who the audience is matters  Consider:  In water softening, zeolite is an exchange resin that releases sodium ions while gaining calcium and magnesium ions.  In water softening, zeolite is a special material that releases sodium into the water while absorbing calcium and magnesium from the water. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 13
  • 14. Technical Definition challenges  Often need further definitions  To define one term introduce several others  Circular definition structurre  One term introduces another and so on until you are back at the original term 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 14
  • 15. Technical definition checklist  On Page 34 of the Text  All questions here are important  Two are common mistakes  Define term using the same term  Define term using terms that also need definition  More information on Technical definitions is contained in the Technical Definition lecture. 9/24/11 - Technical Writing Copyright 2011 - Joanne DeGroat, ECE, OSU 15