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
940
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
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
440
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
190
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
530
A Beginner’s Guide to RFPs and Proposals
Avatar for Jonathan Rick jrick
PRO
0
560
7 Digital Trends Every PR Pro Should Know for 2026
Avatar for Jonathan Rick jrick
PRO
2
2.3k

Other Decks in Business

See All in Business
Remote First: Building Distributed Teams that Win
Avatar for John Nunemaker jnunemaker
PRO
1
130
【ラクス】新卒採用
Avatar for rakus_career rakus_career
0
75k
株式会社カタアシ_サービスのご紹介
Avatar for 株式会社カタアシ kataashi_jp
0
160
GEO Experiments 2026: What We Tested, What Failed, and What Actually Works
Avatar for Thomas Peham thomaspeham
1
800
Practical Guide to Landing Your First Job on Upwork
Avatar for Daisuke Masuda x5gtrn
PRO
0
110
【理学療法士・主任ケアマネの方急募】 入職祝い金 一律10万円支給キャンペーン
Avatar for 髙野尚紀 takanona25
0
120
（5枚）法人営業のキーパーソンを特定する方法　予材管理で最も重要なラインコントロール
Avatar for 横山信弘／絶対達成スライド館 nyattx
PRO
1
650
司コンピュータ株式会社
Avatar for 司コンピュータ tsukasacomputer
0
200
モベンシス会社紹介資料
Avatar for Movensys movensys
0
1.3k
何者かになる必要はあるのか？
Avatar for kobaken kkb1016
0
200
【テックファームホールディングス】中途採用向け会社説明資料
Avatar for Techfirm techfirm
0
660
Canary Inc. Company Deck
Avatar for 株式会社カナリー canaryinc
PRO
2
15k

Featured

See All Featured
What's in a price? How to price your products and services
Avatar for Michael Herold michaelherold
247
13k
brightonSEO & MeasureFest 2025 - Christian Goodrich - Winning strategies for Black Friday CRO & PPC
Avatar for Christian Goodrich cargoodrich
3
680
Art, The Web, and Tiny UX
Avatar for Lynn Fisher lynnandtonic
304
21k
The MySQL Ecosystem @ GitHub 2015
Avatar for Sam Lambert samlambert
251
13k
What the history of the web can teach us about the future of AI
Avatar for Ines Montani inesmontani
PRO
1
530
The Psychology of Web Performance [Beyond Tellerrand 2023]
Avatar for Tammy Everts tammyeverts
49
3.4k
Understanding Cognitive Biases in Performance Measurement
Avatar for Philip Tellis bluesmoon
32
2.9k
Principles of Awesome APIs and How to Build Them.
Avatar for Keavy McMinn keavy
128
17k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
Avatar for Chris Coyier chriscoyier
508
140k
SEOcharity - Dark patterns in SEO and UX: How to avoid them and build a more ethical web
Avatar for Sara Fernández Carmona sarafernandez
0
180
Optimizing for Happiness
Avatar for Tom Preston-Werner mojombo
378
71k
The agentic SEO stack - context over prompts
Avatar for schlessera schlessera
0
770

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