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
160
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
16
untitled config game
ryndaniels
1
2.2k
Designing Sustainable Ops Cultures
ryndaniels
0
1.4k
CI/CD: More than Just Code
ryndaniels
0
260
Building Bridges with Devops
ryndaniels
0
1.4k
Heretical Resilience
ryndaniels
0
1.7k
Building a Brand
ryndaniels
0
100
Effective Devops and Engineering Culture
ryndaniels
2
420
Put Some Dev in Your Devops
ryndaniels
0
1.5k
Other Decks in Technology
See All in Technology
小さな勉強会の始め方、広げ方、あるいは友達の作り方 / How to Start, Grow, and Build Connections with Small Study Groups
ar_tama
6
2.6k
【shownet.conf_】3Dアプローチで守るセキュリティ
shownet
PRO
0
380
Strict Concurrencyにしたらdeinitでクラッシュする話
0si43
0
130
たった一人で始めた音楽制作が気がついたら会社公認の部活動になっていた話〜組織の垣根を超えるコラボレーションを実現するには〜 / On-KAG-bu
piyonakajima
0
220
Product Utilization of Large Language Models Starting Today
ymatsuwitter
3
1.3k
KDD2024参加報告
cyberagentdevelopers
PRO
1
320
Assisted reorganization of data structures
ennael
PRO
0
250
C# 13 / .NET 9 の新機能 (RC 1 時点)
nenonaninu
1
1.3k
YAPC::Hakodateの映像記録を支える技術
godan
4
220
XP matsuri 2024 - 銀河英雄伝説に学ぶ
kawaguti
PRO
3
570
【shownet.conf_】トポロジ図の歩き方
shownet
PRO
0
510
軽いノリで"自動化"に取り組んではいけないという話
tetsuyaooooo
1
480
Featured
See All Featured
jQuery: Nuts, Bolts and Bling
dougneiner
61
7.5k
Robots, Beer and Maslow
schacon
PRO
157
8.2k
Rebuilding a faster, lazier Slack
samanthasiow
79
8.6k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
231
17k
Git: the NoSQL Database
bkeepers
PRO
425
64k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
504
140k
Pencils Down: Stop Designing & Start Developing
hursman
119
11k
Design by the Numbers
sachag
278
19k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
stephaniewalter
280
13k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
45
2k
The Pragmatic Product Professional
lauravandoore
31
6.2k
Reflections from 52 weeks, 52 projects
jeffersonlam
346
20k
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!