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

5 Easy Ways to Make Bad Technical Writing Good

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
43
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.7k
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
570

Other Decks in Business

See All in Business
JAPANSHOP大阪／POP-UPセミナースライド
Avatar for NAOHISA TAKEMURA superpenguin
PRO
0
130
プリザンターの紹介　-　OpenSourceConference 2026 SENDAI
Avatar for Shin Yoshida (S_POCHI) s_pochi
0
200
非エンジニア向け Claude Codeの全社展開~推進とリスク統制のリアル~ #プロヒス2026 #プロダクトヒストリーカンファレンス 2026
Avatar for KAYATO kayato
2
130
station会社紹介資料
Avatar for station株式会社 station_inc
PRO
0
120
NewsPicks Expert説明資料 / NewsPicks Expert Introduction
Avatar for NewsPicks Expert mimir
0
26k
Sotas Company Deck / 会社紹介資料
Avatar for Sotas株式会社 sotas
0
3.1k
株式会社ショーエイ_採用説明資料
Avatar for 株式会社ショーエイ shoeidex
0
200
Mercari-Fact-book_en
Avatar for Mercari, Inc. mercari_inc
2
36k
M3 Career Culture Deck（セールス＆コンサルティング職）
Avatar for エムスリーキャリア m3c
2
330k
チームマネージャー（SV）のご紹介
Avatar for RS rs_mitotakaya
0
510
【結果報告】Claude×Linearで会社のタスク管理をAIにまかせて1ヶ月。業務効率150%向上したが、AIネイティブカンパニーを目指すならもっと「加速への狂気」が必要
Avatar for 長津孝輔 nagatsu
1
640
5年間コードを書かなかったVPoEが なぜ現場に戻ったのか？
Avatar for gessy0129 gessy0129
1
250

Featured

See All Featured
The Success of Rails: Ensuring Growth for the Next 100 Years
Avatar for Eileen M. Uchitelle eileencodes
47
8.2k
Context Engineering - Making Every Token Count
Avatar for Addy Osmani addyosmani
9
1k
GitHub's CSS Performance
Avatar for Jon Rohan jonrohan
1033
470k
Save Time (by Creating Custom Rails Generators)
Avatar for Garrett Dimon garrettdimon
PRO
32
3.6k
Believing is Seeing
Avatar for Spiro Bolos oripsolob
1
160
The Psychology of Web Performance [Beyond Tellerrand 2023]
Avatar for Tammy Everts tammyeverts
49
3.5k
4 Signs Your Business is Dying
Avatar for Josh Pigford shpigford
187
22k
Ten Tips & Tricks for a 🌱 transition
Avatar for Manu Carrasco Molina stuffmc
0
150
Stewardship and Sustainability of Urban and Community Forests
Avatar for Eric Wiseman pwiseman
0
240
The World Runs on Bad Software
Avatar for Brandon Keepers bkeepers
PRO
72
12k
Why You Should Never Use an ORM
Avatar for John Nunemaker jnunemaker
PRO
61
9.9k
エンジニアに許された特別な時間の終わり
Avatar for watany watany
107
250k

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