SlideShare a Scribd company logo
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

Viewers also liked

Business ethics
Business ethicsBusiness ethics
Business ethics
Sajjad Ali
 
Ethical Leadership Theories
Ethical Leadership TheoriesEthical Leadership Theories
Ethical Leadership Theories
catsfood
 
Introduction to Technical Writing
Introduction to Technical WritingIntroduction to Technical Writing
Introduction to Technical Writing
Vince
 
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 Presentation
ra41764n
 
Introduction to technical writing
Introduction to technical writingIntroduction to technical writing
Introduction to technical writing
Adam Tablante
 
Transactional and transformational leadership(1)
Transactional and transformational leadership(1)Transactional and transformational leadership(1)
Transactional and transformational leadership(1)jjadhav1972
 
Ethical Leadership
Ethical LeadershipEthical Leadership
Ethical Leadership
Deepak Khaire
 
Organizational culture and ethical behavior
Organizational culture and ethical behaviorOrganizational culture and ethical behavior
Organizational culture and ethical behavior
Al - Qurmoshi Institute of Business Management, Hyderabad
 

Viewers also liked (10)

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

Overview on Edible Vaccine: Pros & Cons with Mechanism
Overview on Edible Vaccine: Pros & Cons with MechanismOverview on Edible Vaccine: Pros & Cons with Mechanism
Overview on Edible Vaccine: Pros & Cons with Mechanism
DeeptiGupta154
 
Introduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp NetworkIntroduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp Network
TechSoup
 
Francesca Gottschalk - How can education support child empowerment.pptx
Francesca Gottschalk - How can education support child empowerment.pptxFrancesca Gottschalk - How can education support child empowerment.pptx
Francesca Gottschalk - How can education support child empowerment.pptx
EduSkills OECD
 
A Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in EducationA Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in Education
Peter Windle
 
The basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptxThe basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptx
heathfieldcps1
 
Multithreading_in_C++ - std::thread, race condition
Multithreading_in_C++ - std::thread, race conditionMultithreading_in_C++ - std::thread, race condition
Multithreading_in_C++ - std::thread, race condition
Mohammed Sikander
 
Lapbook sobre os Regimes Totalitários.pdf
Lapbook sobre os Regimes Totalitários.pdfLapbook sobre os Regimes Totalitários.pdf
Lapbook sobre os Regimes Totalitários.pdf
Jean Carlos Nunes Paixão
 
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
MysoreMuleSoftMeetup
 
Pride Month Slides 2024 David Douglas School District
Pride Month Slides 2024 David Douglas School DistrictPride Month Slides 2024 David Douglas School District
Pride Month Slides 2024 David Douglas School District
David Douglas School District
 
The Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptxThe Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptx
DhatriParmar
 
How to Make a Field invisible in Odoo 17
How to Make a Field invisible in Odoo 17How to Make a Field invisible in Odoo 17
How to Make a Field invisible in Odoo 17
Celine George
 
Thesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.pptThesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.ppt
EverAndrsGuerraGuerr
 
The Diamonds of 2023-2024 in the IGRA collection
The Diamonds of 2023-2024 in the IGRA collectionThe Diamonds of 2023-2024 in the IGRA collection
The Diamonds of 2023-2024 in the IGRA collection
Israel Genealogy Research Association
 
Chapter 3 - Islamic Banking Products and Services.pptx
Chapter 3 - Islamic Banking Products and Services.pptxChapter 3 - Islamic Banking Products and Services.pptx
Chapter 3 - Islamic Banking Products and Services.pptx
Mohd Adib Abd Muin, Senior Lecturer at Universiti Utara Malaysia
 
JEE1_This_section_contains_FOUR_ questions
JEE1_This_section_contains_FOUR_ questionsJEE1_This_section_contains_FOUR_ questions
JEE1_This_section_contains_FOUR_ questions
ShivajiThube2
 
Acetabularia Information For Class 9 .docx
Acetabularia Information For Class 9  .docxAcetabularia Information For Class 9  .docx
Acetabularia Information For Class 9 .docx
vaibhavrinwa19
 
CACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdfCACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdf
camakaiclarkmusic
 
Azure Interview Questions and Answers PDF By ScholarHat
Azure Interview Questions and Answers PDF By ScholarHatAzure Interview Questions and Answers PDF By ScholarHat
Azure Interview Questions and Answers PDF By ScholarHat
Scholarhat
 
Digital Artifact 1 - 10VCD Environments Unit
Digital Artifact 1 - 10VCD Environments UnitDigital Artifact 1 - 10VCD Environments Unit
Digital Artifact 1 - 10VCD Environments Unit
chanes7
 
2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...
Sandy Millin
 

Recently uploaded (20)

Overview on Edible Vaccine: Pros & Cons with Mechanism
Overview on Edible Vaccine: Pros & Cons with MechanismOverview on Edible Vaccine: Pros & Cons with Mechanism
Overview on Edible Vaccine: Pros & Cons with Mechanism
 
Introduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp NetworkIntroduction to AI for Nonprofits with Tapp Network
Introduction to AI for Nonprofits with Tapp Network
 
Francesca Gottschalk - How can education support child empowerment.pptx
Francesca Gottschalk - How can education support child empowerment.pptxFrancesca Gottschalk - How can education support child empowerment.pptx
Francesca Gottschalk - How can education support child empowerment.pptx
 
A Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in EducationA Strategic Approach: GenAI in Education
A Strategic Approach: GenAI in Education
 
The basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptxThe basics of sentences session 5pptx.pptx
The basics of sentences session 5pptx.pptx
 
Multithreading_in_C++ - std::thread, race condition
Multithreading_in_C++ - std::thread, race conditionMultithreading_in_C++ - std::thread, race condition
Multithreading_in_C++ - std::thread, race condition
 
Lapbook sobre os Regimes Totalitários.pdf
Lapbook sobre os Regimes Totalitários.pdfLapbook sobre os Regimes Totalitários.pdf
Lapbook sobre os Regimes Totalitários.pdf
 
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
Mule 4.6 & Java 17 Upgrade | MuleSoft Mysore Meetup #46
 
Pride Month Slides 2024 David Douglas School District
Pride Month Slides 2024 David Douglas School DistrictPride Month Slides 2024 David Douglas School District
Pride Month Slides 2024 David Douglas School District
 
The Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptxThe Accursed House by Émile Gaboriau.pptx
The Accursed House by Émile Gaboriau.pptx
 
How to Make a Field invisible in Odoo 17
How to Make a Field invisible in Odoo 17How to Make a Field invisible in Odoo 17
How to Make a Field invisible in Odoo 17
 
Thesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.pptThesis Statement for students diagnonsed withADHD.ppt
Thesis Statement for students diagnonsed withADHD.ppt
 
The Diamonds of 2023-2024 in the IGRA collection
The Diamonds of 2023-2024 in the IGRA collectionThe Diamonds of 2023-2024 in the IGRA collection
The Diamonds of 2023-2024 in the IGRA collection
 
Chapter 3 - Islamic Banking Products and Services.pptx
Chapter 3 - Islamic Banking Products and Services.pptxChapter 3 - Islamic Banking Products and Services.pptx
Chapter 3 - Islamic Banking Products and Services.pptx
 
JEE1_This_section_contains_FOUR_ questions
JEE1_This_section_contains_FOUR_ questionsJEE1_This_section_contains_FOUR_ questions
JEE1_This_section_contains_FOUR_ questions
 
Acetabularia Information For Class 9 .docx
Acetabularia Information For Class 9  .docxAcetabularia Information For Class 9  .docx
Acetabularia Information For Class 9 .docx
 
CACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdfCACJapan - GROUP Presentation 1- Wk 4.pdf
CACJapan - GROUP Presentation 1- Wk 4.pdf
 
Azure Interview Questions and Answers PDF By ScholarHat
Azure Interview Questions and Answers PDF By ScholarHatAzure Interview Questions and Answers PDF By ScholarHat
Azure Interview Questions and Answers PDF By ScholarHat
 
Digital Artifact 1 - 10VCD Environments Unit
Digital Artifact 1 - 10VCD Environments UnitDigital Artifact 1 - 10VCD Environments Unit
Digital Artifact 1 - 10VCD Environments Unit
 
2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...2024.06.01 Introducing a competency framework for languag learning materials ...
2024.06.01 Introducing a competency framework for languag learning materials ...
 

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