SlideShare a Scribd company logo
Characteristics of Technical Writing
Characteristics of
Technical Writing
Description of Characteristic
Understanding Why
You are Writing
(Purpose)
Is the purpose of writing…
• To inform: to provide information without expecting any action on the
part of the reader?
• To instruct: to give information in the form of directions, instructions,
procedures, so that readers will be able to do something?
• To propose: to respond to a request for proposals (RFP) or to suggest a
plan of action for a specific problem?
• To recommend: to suggest an action or series of actions based on
alternative possibilities that have been evaluated?
• To persuade: to convince readers to take action, to change their attitudes
or behaviors based on valid opinions and evidence?
Writing for the
Audience
Since the goal of technical writing is information transfer (sending a clear, noise-
free message), what you say and how you say it depends on the audience. The
nature of the audience determines the level of technical detail, the amount of
“context/background” information you provide, and the organization of the
document. It is important to understand who is reading the document so that the
information you convey is transferred effectively. As a writer, it is crucial to have
an awareness of the reader’s knowledge, ability level, and interest in the
information being conveyed.
Satisfying Document
Specifications
(Genre/Type of
Document)
Document specifications include…
• Adherence to document type (genre)--understanding what is expected in
an email vs. a memo, knowing the difference between a proposal and a
recommendation report, and understanding how to write up the results of
an experiment vs. the conclusions;
• Format--many document types specify a specific format be followed, for
example, various professional journals and government documents require
specified
--font
--margins
--labeling for figures and graphics
--line and paragraph spacing
--number of words per document or per section
--section headings and subheadings
Providing Accurate
Information
Being truthful and accurate are the cornerstones of technical writing. Technical
writing is rarely about opinion. Technical and scientific writing is grounded in
fact. It always wrong and unethical to falsify information and data, and that is
particularly true in technical writing. Providing inaccurate or wrong information
causes readers to question your credibility and reliability. It is important to always
report the facts about a particular experiment, even if those facts are not what were
expected or desired.
Organizing
Information Logically
and Linearly
In general, technical writing is organized in a direct, linear format. ALL technical
documents have a clear
• Introduction: this is where you provide motivation and
context/background for the topic/material/information being presented in
the document; always provide the “big picture” before jumping into the
technical details
• Body: this is where the information is expounded upon and where
technical details are given
• Conclusion: this is where the main points are reemphasized and where the
“big picture” is once again discussed
Expressing
Information Clearly
While you may be able to say the same thing in a variety of ways, being clear and
direct are the most important characteristics of technical writing. Expressing
information clearly is crucial; you NEVER want to make your reader work harder
than necessary to understand the message/idea/information you are conveying.
Sentences must have a single meaning with no room for ambiguity. Technical
writing should be direct, not suspenseful. Technical writing is not the place for
poetic language and innuendo.
Using Efficient
Wording
Economy is the name of the game when it comes to technical writing. Technical
documents should be clear and concise, never wordy and flowery. Always choose
words and phrases that are simple and straightforward.
Verbiage Efficient
commence start
endeavor try
a large number of many
in the majority of instances usually
the reason why is that because
alternate choices alternatives
completely eliminate eliminate
connected together connected
an analysis of the data will be made data will be analyzed
made a selection selected
Making
Ideas/Information
Accessible
One of the first things you will notice about technical documents is the page layout
and organizational structure. Technical writing is known for its use of headings
and subheadings and for the way information is made easily accessible by
grouping material into “chunks.” Paragraphs are usually much shorter in technical
writing than in other types of writing. Pages full of text only and long paragraphs
are discouraging to readers. Readers want to be able to quickly access
information, and the best way to help them find the info they need is to provide
them with visual cues such as descriptive headings, and to make use of numbered
lists and bulleted items. Anytime you can make information visual by creating
figures and graphics, try to do so. Figures and tables provide visual relief from all
of the text on the page and help the reader to access important data.
Eliminating “Noise” Nothing is more irritating to a reader than sorting through misspellings, poorly
written sentences, typos, and punctuation problems. Errors such as these make the
writer look uneducated and unprofessional. Careful editing and proofreading
are essential steps in the writing process!
Be sure you know the basic rules for using
• Commas
• Colons
• Semicolons
• Hyphens
• Acronyms (RAM, NASA, GPA)
• Numbers (writing the word vs. using the numeral)
• Equations (use symbols)
• Units of Measure (70 ns, 100 dB)—use abbreviations and symbols
Using Appropriate
Writing Style
Technical writing tends to be rather “dry.” This is because, compared to other
types of writing, the purpose of technical writing is to inform rather than to
entertain. Engineers and scientists are called upon to record and document
information in an objective manner, and in doing so, the style of writing reflects
this objective approach.
• Avoid Personal Pronouns: for most documents, it is unnecessary to use
“I,” “we,” “us,” and especially “you.” Instead of saying, “I (or we) took
measurements,” it is acceptable to say, “Measurements were taken.”
• Passive Voice is OK: while active voice is preferred in most cases, it is
completely acceptable to use passive voice in technical writing.
--Passive Control of the flow is provided by a DJ-12 valve.
--Active A DJ-12 valve controls the flow.
--Passive An ASM chart is shown in Figure 3.
--Active Figure 3 shows an ASM chart.
• Avoid Conversational Tone: technical documents (including most emails)
should employ a formal writing style. Conversational language and
phrasing should be avoided.
--Conversational This lab gave us a good feel for state machines.
--Formal This exercise provided a good background on state
machine design.
--Conversational The D-flip flop was hooked up to the board.
--Formal The D-flip flop was connected to the board for testing.

More Related Content

What's hot

Testing speaking
Testing speakingTesting speaking
Testing speaking
M B
 
Introduction to technical writing
Introduction to technical writingIntroduction to technical writing
Introduction to technical writing
April Jade Arellano
 
Technical Writing
Technical WritingTechnical Writing
Technical Writing
University of Caloocan City
 
Technical writing
Technical writingTechnical writing
Technical writing
ShominiParashar1
 
Technical comunication
Technical comunicationTechnical comunication
Technical comunicationGulfam Hussain
 
Technical writing
Technical writingTechnical writing
Technical writing
JOBERT DOMINGUEZ RONABIO
 
technical writing styles
technical writing stylestechnical writing styles
technical writing styles
Jehn Marie A. Simon
 
Oral communication skills in pedagogical research
Oral communication skills in pedagogical researchOral communication skills in pedagogical research
Oral communication skills in pedagogical research
Wenlie Jean
 
Technical report writing
Technical report writingTechnical report writing
Technical report writingHina Honey
 
Basics of Technical Writing
Basics of Technical WritingBasics of Technical Writing
Basics of Technical Writing
Abdul Wahab Malik
 
Technical writing
Technical writingTechnical writing
Technical writing
Willow Pangket
 
Business Writing
Business WritingBusiness Writing
Business Writing
Nia Noelle
 
Technical and business writing slides
Technical and business writing slidesTechnical and business writing slides
Technical and business writing slides
Self-employed
 
Writing Technical Documents
Writing Technical DocumentsWriting Technical Documents
Writing Technical Documents
ShannonMM
 
Technical Report Writing
Technical Report WritingTechnical Report Writing
Technical Report Writing
Abdul Haseeb
 
Memos and E-mail
Memos and E-mailMemos and E-mail
Memos and E-mail
mcneilkc
 
Writing
WritingWriting
Importance of TECHNICAL report WRITING
Importance of TECHNICAL report WRITINGImportance of TECHNICAL report WRITING
Importance of TECHNICAL report WRITING
Waseem Ali
 
Group Discussion Proficiency Evaluation
Group Discussion Proficiency EvaluationGroup Discussion Proficiency Evaluation
Group Discussion Proficiency Evaluation
akshaylakhi
 

What's hot (20)

Testing speaking
Testing speakingTesting speaking
Testing speaking
 
Introduction to technical writing
Introduction to technical writingIntroduction to technical writing
Introduction to technical writing
 
Technical Writing
Technical WritingTechnical Writing
Technical Writing
 
Technical writing
Technical writingTechnical writing
Technical writing
 
Technical comunication
Technical comunicationTechnical comunication
Technical comunication
 
Technical writing
Technical writingTechnical writing
Technical writing
 
Business Writing
Business WritingBusiness Writing
Business Writing
 
technical writing styles
technical writing stylestechnical writing styles
technical writing styles
 
Oral communication skills in pedagogical research
Oral communication skills in pedagogical researchOral communication skills in pedagogical research
Oral communication skills in pedagogical research
 
Technical report writing
Technical report writingTechnical report writing
Technical report writing
 
Basics of Technical Writing
Basics of Technical WritingBasics of Technical Writing
Basics of Technical Writing
 
Technical writing
Technical writingTechnical writing
Technical writing
 
Business Writing
Business WritingBusiness Writing
Business Writing
 
Technical and business writing slides
Technical and business writing slidesTechnical and business writing slides
Technical and business writing slides
 
Writing Technical Documents
Writing Technical DocumentsWriting Technical Documents
Writing Technical Documents
 
Technical Report Writing
Technical Report WritingTechnical Report Writing
Technical Report Writing
 
Memos and E-mail
Memos and E-mailMemos and E-mail
Memos and E-mail
 
Writing
WritingWriting
Writing
 
Importance of TECHNICAL report WRITING
Importance of TECHNICAL report WRITINGImportance of TECHNICAL report WRITING
Importance of TECHNICAL report WRITING
 
Group Discussion Proficiency Evaluation
Group Discussion Proficiency EvaluationGroup Discussion Proficiency Evaluation
Group Discussion Proficiency Evaluation
 

Viewers also liked

Power Point
Power PointPower Point
Power PointMaSolP
 
Dr. dolas , keep your cooll
Dr. dolas , keep your coollDr. dolas , keep your cooll
Dr. dolas , keep your cooll
Globalvisionfoundation
 
Paperless Session by Santiago B. Cane, Jr.
Paperless Session by Santiago B. Cane, Jr.Paperless Session by Santiago B. Cane, Jr.
Paperless Session by Santiago B. Cane, Jr.
Rodalyn Salvaleon
 
Finding Teachers Test
Finding Teachers TestFinding Teachers Test
Finding Teachers Test
David Weller
 
About Miles Printing
About Miles PrintingAbout Miles Printing
About Miles Printing
graphixlink1222
 
Nn Emb Artpieces Aug 2011
Nn Emb Artpieces Aug 2011Nn Emb Artpieces Aug 2011
Nn Emb Artpieces Aug 2011
nickicarter
 
P k slide show
P k slide showP k slide show
P k slide show
prasathk313
 
Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...
Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...
Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...
fem talent
 
Han
HanHan
I want to live forever!
I want to live forever!I want to live forever!
I want to live forever!
Laura Munroe
 
A nimation project
A nimation projectA nimation project
A nimation projectprasathk313
 
10 virus-mas-peligrosos-de-todo-el-tiempo
10 virus-mas-peligrosos-de-todo-el-tiempo10 virus-mas-peligrosos-de-todo-el-tiempo
10 virus-mas-peligrosos-de-todo-el-tiempo
Alexei Mamani Coaquira
 
Nature lightning
Nature lightningNature lightning
Nature lightning再添 張
 
Blogging presentation
Blogging presentationBlogging presentation
Blogging presentationTraci Van
 

Viewers also liked (20)

Tenses
TensesTenses
Tenses
 
Power Point
Power PointPower Point
Power Point
 
First period
First periodFirst period
First period
 
Avonmore super milk
Avonmore super milkAvonmore super milk
Avonmore super milk
 
Dr. dolas , keep your cooll
Dr. dolas , keep your coollDr. dolas , keep your cooll
Dr. dolas , keep your cooll
 
Paperless Session by Santiago B. Cane, Jr.
Paperless Session by Santiago B. Cane, Jr.Paperless Session by Santiago B. Cane, Jr.
Paperless Session by Santiago B. Cane, Jr.
 
Finding Teachers Test
Finding Teachers TestFinding Teachers Test
Finding Teachers Test
 
About Miles Printing
About Miles PrintingAbout Miles Printing
About Miles Printing
 
Nn Emb Artpieces Aug 2011
Nn Emb Artpieces Aug 2011Nn Emb Artpieces Aug 2011
Nn Emb Artpieces Aug 2011
 
P k slide show
P k slide showP k slide show
P k slide show
 
Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...
Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...
Discurs sobre igualtat de l'eurodiputada sueca Cecilia Wikström al II fem.tal...
 
Han
HanHan
Han
 
Global warming
Global warmingGlobal warming
Global warming
 
I want to live forever!
I want to live forever!I want to live forever!
I want to live forever!
 
A nimation project
A nimation projectA nimation project
A nimation project
 
10 virus-mas-peligrosos-de-todo-el-tiempo
10 virus-mas-peligrosos-de-todo-el-tiempo10 virus-mas-peligrosos-de-todo-el-tiempo
10 virus-mas-peligrosos-de-todo-el-tiempo
 
Prophet muhammad
Prophet muhammadProphet muhammad
Prophet muhammad
 
Nature lightning
Nature lightningNature lightning
Nature lightning
 
Blogging presentation
Blogging presentationBlogging presentation
Blogging presentation
 
08 chapter 1
08 chapter 108 chapter 1
08 chapter 1
 

Similar to Characteristics of technical_writing

Intro to Technical-Writing-Powerpoint-ppt
Intro to Technical-Writing-Powerpoint-pptIntro to Technical-Writing-Powerpoint-ppt
Intro to Technical-Writing-Powerpoint-ppt
lilibethnono59
 
Technical writings for academics
Technical writings for academicsTechnical writings for academics
Technical writings for academics
Tapan Barui
 
460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt
460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt
460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt
MuhammadSalman585
 
Technical Writingg.pptx
Technical Writingg.pptxTechnical Writingg.pptx
Technical Writingg.pptx
MuammerAlakary
 
An introduction to Technical Report Writing
An introduction to Technical Report WritingAn introduction to Technical Report Writing
An introduction to Technical Report Writing
assande01
 
Professional Communication in Computing - Writing
Professional Communication in Computing - WritingProfessional Communication in Computing - Writing
Professional Communication in Computing - Writing
Upekha Vandebona
 
Technical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docx
Technical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docxTechnical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docx
Technical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docx
jacqueliner9
 
Presentation1.update.pptx
Presentation1.update.pptxPresentation1.update.pptx
Presentation1.update.pptx
sefefehunegnaw1
 
Azam baloch
Azam balochAzam baloch
Azam baloch
AzamBaloch6
 
Lecture 5 - Writing a project report
Lecture 5 - Writing a project reportLecture 5 - Writing a project report
Lecture 5 - Writing a project report
Virtu Institute
 
WritingProcessForBusinessAnalysis-Guide
WritingProcessForBusinessAnalysis-GuideWritingProcessForBusinessAnalysis-Guide
WritingProcessForBusinessAnalysis-GuideJas Mahay
 
Elements of technical document
Elements of technical documentElements of technical document
Elements of technical document
MohammadFaisal170
 
Technical report-writing-1
Technical report-writing-1Technical report-writing-1
Technical Writing
Technical WritingTechnical Writing
Technical Writing
unknown942
 
Editing And Proofreading Your Research Paper - Pubrica.pptx
Editing And Proofreading Your Research Paper - Pubrica.pptxEditing And Proofreading Your Research Paper - Pubrica.pptx
Editing And Proofreading Your Research Paper - Pubrica.pptx
Pubrica
 
Giving Oral Presentations
Giving Oral PresentationsGiving Oral Presentations
Giving Oral Presentationsjim_porter
 
REPORT WRITING
REPORT WRITINGREPORT WRITING
REPORT WRITING
tulasikrishnaravi
 
Writing successful white papers
Writing successful white papersWriting successful white papers
Writing successful white papers
Amanda Sturgill
 
How ti write a good scientific paper.ppt
How ti write a good scientific paper.pptHow ti write a good scientific paper.ppt
How ti write a good scientific paper.ppt
obedcudjoe1
 
Writing good scientific papers: Do more and more
Writing good scientific papers: Do more and moreWriting good scientific papers: Do more and more
Writing good scientific papers: Do more and more
AkramLaKilo1
 

Similar to Characteristics of technical_writing (20)

Intro to Technical-Writing-Powerpoint-ppt
Intro to Technical-Writing-Powerpoint-pptIntro to Technical-Writing-Powerpoint-ppt
Intro to Technical-Writing-Powerpoint-ppt
 
Technical writings for academics
Technical writings for academicsTechnical writings for academics
Technical writings for academics
 
460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt
460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt
460830482-202475823-Technical-Writing-Powerpoint-ppt.ppt
 
Technical Writingg.pptx
Technical Writingg.pptxTechnical Writingg.pptx
Technical Writingg.pptx
 
An introduction to Technical Report Writing
An introduction to Technical Report WritingAn introduction to Technical Report Writing
An introduction to Technical Report Writing
 
Professional Communication in Computing - Writing
Professional Communication in Computing - WritingProfessional Communication in Computing - Writing
Professional Communication in Computing - Writing
 
Technical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docx
Technical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docxTechnical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docx
Technical Writing Annemarie Hamlin, Chris Rubio, Michele DeSilva.docx
 
Presentation1.update.pptx
Presentation1.update.pptxPresentation1.update.pptx
Presentation1.update.pptx
 
Azam baloch
Azam balochAzam baloch
Azam baloch
 
Lecture 5 - Writing a project report
Lecture 5 - Writing a project reportLecture 5 - Writing a project report
Lecture 5 - Writing a project report
 
WritingProcessForBusinessAnalysis-Guide
WritingProcessForBusinessAnalysis-GuideWritingProcessForBusinessAnalysis-Guide
WritingProcessForBusinessAnalysis-Guide
 
Elements of technical document
Elements of technical documentElements of technical document
Elements of technical document
 
Technical report-writing-1
Technical report-writing-1Technical report-writing-1
Technical report-writing-1
 
Technical Writing
Technical WritingTechnical Writing
Technical Writing
 
Editing And Proofreading Your Research Paper - Pubrica.pptx
Editing And Proofreading Your Research Paper - Pubrica.pptxEditing And Proofreading Your Research Paper - Pubrica.pptx
Editing And Proofreading Your Research Paper - Pubrica.pptx
 
Giving Oral Presentations
Giving Oral PresentationsGiving Oral Presentations
Giving Oral Presentations
 
REPORT WRITING
REPORT WRITINGREPORT WRITING
REPORT WRITING
 
Writing successful white papers
Writing successful white papersWriting successful white papers
Writing successful white papers
 
How ti write a good scientific paper.ppt
How ti write a good scientific paper.pptHow ti write a good scientific paper.ppt
How ti write a good scientific paper.ppt
 
Writing good scientific papers: Do more and more
Writing good scientific papers: Do more and moreWriting good scientific papers: Do more and more
Writing good scientific papers: Do more and more
 

Recently uploaded

Introduction to Amazon company 111111111111
Introduction to Amazon company 111111111111Introduction to Amazon company 111111111111
Introduction to Amazon company 111111111111
zoyaansari11365
 
Tata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s Dholera
Tata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s DholeraTata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s Dholera
Tata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s Dholera
Avirahi City Dholera
 
Memorandum Of Association Constitution of Company.ppt
Memorandum Of Association Constitution of Company.pptMemorandum Of Association Constitution of Company.ppt
Memorandum Of Association Constitution of Company.ppt
seri bangash
 
20240425_ TJ Communications Credentials_compressed.pdf
20240425_ TJ Communications Credentials_compressed.pdf20240425_ TJ Communications Credentials_compressed.pdf
20240425_ TJ Communications Credentials_compressed.pdf
tjcomstrang
 
FINAL PRESENTATION.pptx12143241324134134
FINAL PRESENTATION.pptx12143241324134134FINAL PRESENTATION.pptx12143241324134134
FINAL PRESENTATION.pptx12143241324134134
LR1709MUSIC
 
Brand Analysis for an artist named Struan
Brand Analysis for an artist named StruanBrand Analysis for an artist named Struan
Brand Analysis for an artist named Struan
sarahvanessa51503
 
The effects of customers service quality and online reviews on customer loyal...
The effects of customers service quality and online reviews on customer loyal...The effects of customers service quality and online reviews on customer loyal...
The effects of customers service quality and online reviews on customer loyal...
balatucanapplelovely
 
ikea_woodgreen_petscharity_cat-alogue_digital.pdf
ikea_woodgreen_petscharity_cat-alogue_digital.pdfikea_woodgreen_petscharity_cat-alogue_digital.pdf
ikea_woodgreen_petscharity_cat-alogue_digital.pdf
agatadrynko
 
ENTREPRENEURSHIP TRAINING.ppt for graduating class (1).ppt
ENTREPRENEURSHIP TRAINING.ppt for graduating class (1).pptENTREPRENEURSHIP TRAINING.ppt for graduating class (1).ppt
ENTREPRENEURSHIP TRAINING.ppt for graduating class (1).ppt
zechu97
 
falcon-invoice-discounting-a-premier-platform-for-investors-in-india
falcon-invoice-discounting-a-premier-platform-for-investors-in-indiafalcon-invoice-discounting-a-premier-platform-for-investors-in-india
falcon-invoice-discounting-a-premier-platform-for-investors-in-india
Falcon Invoice Discounting
 
5 Things You Need To Know Before Hiring a Videographer
5 Things You Need To Know Before Hiring a Videographer5 Things You Need To Know Before Hiring a Videographer
5 Things You Need To Know Before Hiring a Videographer
ofm712785
 
Business Valuation Principles for Entrepreneurs
Business Valuation Principles for EntrepreneursBusiness Valuation Principles for Entrepreneurs
Business Valuation Principles for Entrepreneurs
Ben Wann
 
April 2024 Nostalgia Products Newsletter
April 2024 Nostalgia Products NewsletterApril 2024 Nostalgia Products Newsletter
April 2024 Nostalgia Products Newsletter
NathanBaughman3
 
Attending a job Interview for B1 and B2 Englsih learners
Attending a job Interview for B1 and B2 Englsih learnersAttending a job Interview for B1 and B2 Englsih learners
Attending a job Interview for B1 and B2 Englsih learners
Erika906060
 
Improving profitability for small business
Improving profitability for small businessImproving profitability for small business
Improving profitability for small business
Ben Wann
 
amptalk_RecruitingDeck_english_2024.06.05
amptalk_RecruitingDeck_english_2024.06.05amptalk_RecruitingDeck_english_2024.06.05
amptalk_RecruitingDeck_english_2024.06.05
marketing317746
 
Maksym Vyshnivetskyi: PMO Quality Management (UA)
Maksym Vyshnivetskyi: PMO Quality Management (UA)Maksym Vyshnivetskyi: PMO Quality Management (UA)
Maksym Vyshnivetskyi: PMO Quality Management (UA)
Lviv Startup Club
 
Discover the innovative and creative projects that highlight my journey throu...
Discover the innovative and creative projects that highlight my journey throu...Discover the innovative and creative projects that highlight my journey throu...
Discover the innovative and creative projects that highlight my journey throu...
dylandmeas
 
The-McKinsey-7S-Framework. strategic management
The-McKinsey-7S-Framework. strategic managementThe-McKinsey-7S-Framework. strategic management
The-McKinsey-7S-Framework. strategic management
Bojamma2
 
一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理
一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理
一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理
taqyed
 

Recently uploaded (20)

Introduction to Amazon company 111111111111
Introduction to Amazon company 111111111111Introduction to Amazon company 111111111111
Introduction to Amazon company 111111111111
 
Tata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s Dholera
Tata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s DholeraTata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s Dholera
Tata Group Dials Taiwan for Its Chipmaking Ambition in Gujarat’s Dholera
 
Memorandum Of Association Constitution of Company.ppt
Memorandum Of Association Constitution of Company.pptMemorandum Of Association Constitution of Company.ppt
Memorandum Of Association Constitution of Company.ppt
 
20240425_ TJ Communications Credentials_compressed.pdf
20240425_ TJ Communications Credentials_compressed.pdf20240425_ TJ Communications Credentials_compressed.pdf
20240425_ TJ Communications Credentials_compressed.pdf
 
FINAL PRESENTATION.pptx12143241324134134
FINAL PRESENTATION.pptx12143241324134134FINAL PRESENTATION.pptx12143241324134134
FINAL PRESENTATION.pptx12143241324134134
 
Brand Analysis for an artist named Struan
Brand Analysis for an artist named StruanBrand Analysis for an artist named Struan
Brand Analysis for an artist named Struan
 
The effects of customers service quality and online reviews on customer loyal...
The effects of customers service quality and online reviews on customer loyal...The effects of customers service quality and online reviews on customer loyal...
The effects of customers service quality and online reviews on customer loyal...
 
ikea_woodgreen_petscharity_cat-alogue_digital.pdf
ikea_woodgreen_petscharity_cat-alogue_digital.pdfikea_woodgreen_petscharity_cat-alogue_digital.pdf
ikea_woodgreen_petscharity_cat-alogue_digital.pdf
 
ENTREPRENEURSHIP TRAINING.ppt for graduating class (1).ppt
ENTREPRENEURSHIP TRAINING.ppt for graduating class (1).pptENTREPRENEURSHIP TRAINING.ppt for graduating class (1).ppt
ENTREPRENEURSHIP TRAINING.ppt for graduating class (1).ppt
 
falcon-invoice-discounting-a-premier-platform-for-investors-in-india
falcon-invoice-discounting-a-premier-platform-for-investors-in-indiafalcon-invoice-discounting-a-premier-platform-for-investors-in-india
falcon-invoice-discounting-a-premier-platform-for-investors-in-india
 
5 Things You Need To Know Before Hiring a Videographer
5 Things You Need To Know Before Hiring a Videographer5 Things You Need To Know Before Hiring a Videographer
5 Things You Need To Know Before Hiring a Videographer
 
Business Valuation Principles for Entrepreneurs
Business Valuation Principles for EntrepreneursBusiness Valuation Principles for Entrepreneurs
Business Valuation Principles for Entrepreneurs
 
April 2024 Nostalgia Products Newsletter
April 2024 Nostalgia Products NewsletterApril 2024 Nostalgia Products Newsletter
April 2024 Nostalgia Products Newsletter
 
Attending a job Interview for B1 and B2 Englsih learners
Attending a job Interview for B1 and B2 Englsih learnersAttending a job Interview for B1 and B2 Englsih learners
Attending a job Interview for B1 and B2 Englsih learners
 
Improving profitability for small business
Improving profitability for small businessImproving profitability for small business
Improving profitability for small business
 
amptalk_RecruitingDeck_english_2024.06.05
amptalk_RecruitingDeck_english_2024.06.05amptalk_RecruitingDeck_english_2024.06.05
amptalk_RecruitingDeck_english_2024.06.05
 
Maksym Vyshnivetskyi: PMO Quality Management (UA)
Maksym Vyshnivetskyi: PMO Quality Management (UA)Maksym Vyshnivetskyi: PMO Quality Management (UA)
Maksym Vyshnivetskyi: PMO Quality Management (UA)
 
Discover the innovative and creative projects that highlight my journey throu...
Discover the innovative and creative projects that highlight my journey throu...Discover the innovative and creative projects that highlight my journey throu...
Discover the innovative and creative projects that highlight my journey throu...
 
The-McKinsey-7S-Framework. strategic management
The-McKinsey-7S-Framework. strategic managementThe-McKinsey-7S-Framework. strategic management
The-McKinsey-7S-Framework. strategic management
 
一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理
一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理
一比一原版加拿大渥太华大学毕业证(uottawa毕业证书)如何办理
 

Characteristics of technical_writing

  • 1. Characteristics of Technical Writing Characteristics of Technical Writing Description of Characteristic Understanding Why You are Writing (Purpose) Is the purpose of writing… • To inform: to provide information without expecting any action on the part of the reader? • To instruct: to give information in the form of directions, instructions, procedures, so that readers will be able to do something? • To propose: to respond to a request for proposals (RFP) or to suggest a plan of action for a specific problem? • To recommend: to suggest an action or series of actions based on alternative possibilities that have been evaluated? • To persuade: to convince readers to take action, to change their attitudes or behaviors based on valid opinions and evidence? Writing for the Audience Since the goal of technical writing is information transfer (sending a clear, noise- free message), what you say and how you say it depends on the audience. The nature of the audience determines the level of technical detail, the amount of “context/background” information you provide, and the organization of the document. It is important to understand who is reading the document so that the information you convey is transferred effectively. As a writer, it is crucial to have an awareness of the reader’s knowledge, ability level, and interest in the information being conveyed. Satisfying Document Specifications (Genre/Type of Document) Document specifications include… • Adherence to document type (genre)--understanding what is expected in an email vs. a memo, knowing the difference between a proposal and a recommendation report, and understanding how to write up the results of an experiment vs. the conclusions; • Format--many document types specify a specific format be followed, for example, various professional journals and government documents require specified --font --margins --labeling for figures and graphics --line and paragraph spacing --number of words per document or per section --section headings and subheadings Providing Accurate Information Being truthful and accurate are the cornerstones of technical writing. Technical writing is rarely about opinion. Technical and scientific writing is grounded in fact. It always wrong and unethical to falsify information and data, and that is particularly true in technical writing. Providing inaccurate or wrong information causes readers to question your credibility and reliability. It is important to always report the facts about a particular experiment, even if those facts are not what were expected or desired.
  • 2. Organizing Information Logically and Linearly In general, technical writing is organized in a direct, linear format. ALL technical documents have a clear • Introduction: this is where you provide motivation and context/background for the topic/material/information being presented in the document; always provide the “big picture” before jumping into the technical details • Body: this is where the information is expounded upon and where technical details are given • Conclusion: this is where the main points are reemphasized and where the “big picture” is once again discussed Expressing Information Clearly While you may be able to say the same thing in a variety of ways, being clear and direct are the most important characteristics of technical writing. Expressing information clearly is crucial; you NEVER want to make your reader work harder than necessary to understand the message/idea/information you are conveying. Sentences must have a single meaning with no room for ambiguity. Technical writing should be direct, not suspenseful. Technical writing is not the place for poetic language and innuendo. Using Efficient Wording Economy is the name of the game when it comes to technical writing. Technical documents should be clear and concise, never wordy and flowery. Always choose words and phrases that are simple and straightforward. Verbiage Efficient commence start endeavor try a large number of many in the majority of instances usually the reason why is that because alternate choices alternatives completely eliminate eliminate connected together connected an analysis of the data will be made data will be analyzed made a selection selected Making Ideas/Information Accessible One of the first things you will notice about technical documents is the page layout and organizational structure. Technical writing is known for its use of headings and subheadings and for the way information is made easily accessible by grouping material into “chunks.” Paragraphs are usually much shorter in technical writing than in other types of writing. Pages full of text only and long paragraphs are discouraging to readers. Readers want to be able to quickly access information, and the best way to help them find the info they need is to provide them with visual cues such as descriptive headings, and to make use of numbered lists and bulleted items. Anytime you can make information visual by creating figures and graphics, try to do so. Figures and tables provide visual relief from all of the text on the page and help the reader to access important data. Eliminating “Noise” Nothing is more irritating to a reader than sorting through misspellings, poorly written sentences, typos, and punctuation problems. Errors such as these make the writer look uneducated and unprofessional. Careful editing and proofreading are essential steps in the writing process! Be sure you know the basic rules for using • Commas • Colons • Semicolons • Hyphens • Acronyms (RAM, NASA, GPA) • Numbers (writing the word vs. using the numeral) • Equations (use symbols) • Units of Measure (70 ns, 100 dB)—use abbreviations and symbols
  • 3. Using Appropriate Writing Style Technical writing tends to be rather “dry.” This is because, compared to other types of writing, the purpose of technical writing is to inform rather than to entertain. Engineers and scientists are called upon to record and document information in an objective manner, and in doing so, the style of writing reflects this objective approach. • Avoid Personal Pronouns: for most documents, it is unnecessary to use “I,” “we,” “us,” and especially “you.” Instead of saying, “I (or we) took measurements,” it is acceptable to say, “Measurements were taken.” • Passive Voice is OK: while active voice is preferred in most cases, it is completely acceptable to use passive voice in technical writing. --Passive Control of the flow is provided by a DJ-12 valve. --Active A DJ-12 valve controls the flow. --Passive An ASM chart is shown in Figure 3. --Active Figure 3 shows an ASM chart. • Avoid Conversational Tone: technical documents (including most emails) should employ a formal writing style. Conversational language and phrasing should be avoided. --Conversational This lab gave us a good feel for state machines. --Formal This exercise provided a good background on state machine design. --Conversational The D-flip flop was hooked up to the board. --Formal The D-flip flop was connected to the board for testing.