Upgrade to Pro — share decks privately, control downloads, hide ads and more …

5 Easy Ways to Make Bad Technical Writing Good

Sponsored · Ship Features Fearlessly Turn features on and off without deploys. Used by thousands of Ruby developers. →
Avatar for Jonathan Rick Jonathan Rick PRO
May 04, 2018
Business
980
0

5 Easy Ways to Make Bad Technical Writing Good

Clear, accurate, and concise text makes interfaces more usable and builds.

Avatar for Jonathan Rick

Jonathan Rick PRO

May 04, 2018

More Decks by Jonathan Rick

See All by Jonathan Rick
Is This the Right Course for You?
Avatar for Jonathan Rick jrick
PRO
0
41
Everything You Wanted to Know About Wikipedia But Were Too Embarrassed to Ask
Avatar for Jonathan Rick jrick
PRO
0
19k
Sales After Covid: How to Sell in a Post-Pandemic World
Avatar for Jonathan Rick jrick
PRO
1
1.2k
Healthcare Phrases That Are Almost Always Misunderstood
Avatar for Jonathan Rick jrick
PRO
1
460
This Is Why Donald Trump Is Killing Joe Biden in Fundraising
Avatar for Jonathan Rick jrick
PRO
0
1.6k
How to Manage Your Inbox and Mental Health During a Pandemic
Avatar for Jonathan Rick jrick
PRO
0
200
How to Write a Talking Point
Avatar for Jonathan Rick jrick
PRO
0
2.4k
What's Wrong With These RFPs?
Avatar for Jonathan Rick jrick
PRO
0
540
A Beginner’s Guide to RFPs and Proposals
Avatar for Jonathan Rick jrick
PRO
0
560

Other Decks in Business

See All in Business
2025年度「海の家プロジェクト」ピッチ資料
Avatar for Brush brush2026
0
240
Nishika_採用ピッチ資料
Avatar for Kaede Suzuki nishika_kae
0
130
kakaopiccoma_engineer_recruitingguide
Avatar for Kakao piccoma Corp. kakaojapan
2
180
会社説明資料
Avatar for 倉島悠月 kurashima
0
260
CSRレポート2026_ギークス株式会社
Avatar for ギークス株式会社 geechs
PRO
0
210
ファブリカホールディングス_2026年3月期通期説明資料
Avatar for fabrica holdings fabrica_com
1
5.9k
コーポレートストーリー（新規投資家様向け会社説明資料）
Avatar for GA technologies gatechnologies
2
19k
メンバーズ会社紹介資料/Members company brochure
Avatar for 株式会社メンバーズ members_recruiting
0
37k
パーソルクロステクノロジー_DXソリューション本部のご紹介 / Introduction_of_dx
Avatar for パーソルクロステクノロジー株式会社（プライムSI事業／コンサルティング事業） pxt_gs_ssol
0
2k
M3 Career Culture Deck（セールス＆コンサルティング職）
Avatar for エムスリーキャリア m3c
2
320k
自分のハンドルを握る〜AI時代だからこそ求められるセルフマネジメントの技術/Self-Management Skills Needed More Than Ever in the AI Era
Avatar for 小田中育生 ikuodanaka
0
160
jpax-introduction
Avatar for 日本頭脳基盤株式会社 jpax
0
1.1k

Featured

See All Featured
Into the Great Unknown - MozCon
Avatar for Noah Learner thekraken
41
2.6k
A brief & incomplete history of 
UX Design for the World Wide Web: 1989–2019
Avatar for Jason CranfordTeague jct
2
390
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
35
2.5k
The Language of Interfaces
Avatar for Des Traynor destraynor
162
27k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
Avatar for Tammy Everts tammyeverts
55
3.4k
How to build a perfect <img>
Avatar for Jono Alderson jonoalderson
1
5.6k
XXLCSS - How to scale CSS and keep your sanity
Avatar for Zaharenia Atzitzikaki sugarenia
250
1.3M
Design and Strategy: How to Deal with People Who Don’t "Get" Design
Avatar for Morgane Peng morganepeng
133
19k
Digital Ethics as a Driver of Design Innovation
Avatar for Per Axbom axbom
PRO
1
310
Learning to Love Humans: Emotional Interface Design
Avatar for Aarron Walter aarron
275
41k
svc-hook: hooking system calls on ARM64 by binary rewriting
Avatar for Akira Moroo retrage
2
290
Data-driven link building: lessons from a $708K investment (BrightonSEO talk)
Avatar for Szymon Słowik szymonslowik
1
1.1k

Transcript

  1. 5 Easy Ways to Make Bad Technical Writing Good

  2. 1

  3. 2

  4. 3

  5. 3

  6. 4

  7. 5

  8. 5

  9. http://material.io/guidelines/style/writing.html