Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Working on Wordsmithing
Search
Ryn Daniels
August 23, 2017
Technology
0
170
Working on Wordsmithing
Presented at Write/Speak/Code 2017
Ryn Daniels
August 23, 2017
Tweet
Share
More Decks by Ryn Daniels
See All by Ryn Daniels
Dungeons and Devops
ryndaniels
0
33
untitled config game
ryndaniels
1
2.4k
Designing Sustainable Ops Cultures
ryndaniels
0
1.5k
CI/CD: More than Just Code
ryndaniels
0
300
Building Bridges with Devops
ryndaniels
0
1.5k
Heretical Resilience
ryndaniels
0
1.9k
Building a Brand
ryndaniels
0
120
Effective Devops and Engineering Culture
ryndaniels
2
430
Put Some Dev in Your Devops
ryndaniels
0
1.7k
Other Decks in Technology
See All in Technology
ロールが細分化された組織でSREは何をするか?
tgidgd
1
420
Maintainer Meetupで「生の声」を聞く ~講演だけじゃないKubeCon
logica0419
0
110
microCMSではじめるAIライティング
himaratsu
0
150
20250708オープンエンドな探索と知識発見
sakana_ai
PRO
4
1k
本当にわかりやすいAIエージェント入門
segavvy
1
400
ポストコロナ時代の SaaS におけるコスト削減の意義
izzii
1
470
研究開発部メンバーの働き⽅ / Sansan R&D Profile
sansan33
PRO
3
18k
Introduction to Bill One Development Engineer
sansan33
PRO
0
260
Bill One 開発エンジニア 紹介資料
sansan33
PRO
4
13k
Autify Company Deck
autifyhq
2
44k
サービスを止めるな! DDoS攻撃へのスマートな備えと最前線の事例
coconala_engineer
1
180
Transformerを用いたアイテム間の 相互影響を考慮したレコメンドリスト生成
recruitengineers
PRO
2
440
Featured
See All Featured
For a Future-Friendly Web
brad_frost
179
9.8k
Optimizing for Happiness
mojombo
379
70k
A better future with KSS
kneath
238
17k
It's Worth the Effort
3n
185
28k
Code Review Best Practice
trishagee
69
19k
Build your cross-platform service in a week with App Engine
jlugia
231
18k
Site-Speed That Sticks
csswizardry
10
700
How GitHub (no longer) Works
holman
314
140k
Java REST API Framework Comparison - PWX 2021
mraible
31
8.7k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
248
1.3M
The Cult of Friendly URLs
andyhume
79
6.5k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
229
22k
Transcript
Working on Wordsmithing Ryn Daniels Write/Speak/Code 2017
@rynchantress w/s/c 2017 Ryn Daniels they/them - @rynchantress Infrastructure Ops
Witch, Travis CI
@rynchantress w/s/c 2017 professional writing
@rynchantress w/s/c 2017 professional != formal
Let’s get going.
@rynchantress w/s/c 2017 What do we write?
@rynchantress w/s/c 2017 short long formal informal
@rynchantress w/s/c 2017 short long formal informal Chat Books Conference
abstracts Talk proposals Resumés Blog posts Pull requests Project proposals Work emails Code reviews Code comments Cover Letters Retrospectives
@rynchantress w/s/c 2017 good writing provides useful, timely information that
the reader needs.
@rynchantress 3 2 1 w/s/c 2017 agenda PREPARING: IDENTIFYING CONTENT
WRITING: PROCESS AND STYLE REVIEWING: FEEDBACK AND EDITING
@rynchantress w/s/c 2017 Preparing: identifying content
@rynchantress w/s/c 2017 Content: WHAT are you trying to communicate?
@rynchantress w/s/c 2017 what is the outcome I want from
the people who read this? Ask yourself:
@rynchantress w/s/c 2017 which people do i want (or need)
to read this? Ask yourself:
@rynchantress w/s/c 2017 identify your audience
@rynchantress w/s/c 2017
@rynchantress w/s/c 2017
@rynchantress w/s/c 2017 woah that’s a lot of text!
None
@rynchantress w/s/c 2017 Writing: Process and style
@rynchantress w/s/c 2017 start with a summary (or a tl;dr)
None
@rynchantress w/s/c 2017 create an outline
None
None
@rynchantress w/s/c 2017 break content into sections
(pay attention to attention spans)
@rynchantress w/s/c 2017 blargh
None
@rynchantress w/s/c 2017 making information usable
@rynchantress w/s/c 2017 include examples
@rynchantress w/s/c 2017
None
@rynchantress w/s/c 2017 include different levels of content
@rynchantress w/s/c 2017
@rynchantress w/s/c 2017 err on the side of more information
@rynchantress w/s/c 2017 blargh cat tax!
@rynchantress w/s/c 2017 finding your style
@rynchantress w/s/c 2017 Style guides! (not the code kind)
@rynchantress w/s/c 2017
@rynchantress w/s/c 2017 read the backscroll
@rynchantress w/s/c 2017 short long formal informal Chat Books Conference
abstracts Talk proposals Resumés Blog posts Pull requests Project proposals Work emails Code reviews Code comments Cover Letters Retrospectives
@rynchantress w/s/c 2017 Reviewing: Feedback and Editing
@rynchantress w/s/c 2017 blargh
@rynchantress w/s/c 2017 getting feedback
@rynchantress w/s/c 2017
@rynchantress w/s/c 2017 specific feedback groups •Cheerleaders •Critical eyes •Subject
matter experts •Non-SMEs •Your target audience •Your heroes
@rynchantress w/s/c 2017 blargh don’t read the comments
@rynchantress w/s/c 2017 The editing process
@rynchantress w/s/c 2017 •Write •Read through once (and spellcheck!) •Re-read
tricky sections •Wait X amount of time •Internal Feedback •External Feedback •Publish/Send! Repeat as needed }
@rynchantress w/s/c 2017 how much is “as needed”? How much
time is “x”?
@rynchantress w/s/c 2017 Value Axis 0 50 100 150 200
April May June July August September Length/formality of document Time spent editing
@rynchantress w/s/c 2017 Length/formality of document Number of cat pictures
0 50 100 150 200 April May June July August September
@rynchantress w/s/c 2017
@rynchantress w/s/c 2017 don’t let the perfect be the enemy
of the good.
Cat Tax
@rynchantress w/s/c 2017 tl;dr
@rynchantress w/s/c 2017 •Identify audience and takeaways •Write some words!
•Ask for and get feedback •iterate (and iterate) and ship •Keep practicing
@rynchantress w/s/c 2017 Thank you!