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
32
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.6k
Other Decks in Technology
See All in Technology
Snowflake Summit 2025全体振り返り / Snowflake Summit 2025 Overall Review
mtpooh
2
390
PHP開発者のためのSOLID原則再入門 #phpcon / PHP Conference Japan 2025
shogogg
4
700
TechLION vol.41~MySQLユーザ会のほうから来ました / techlion41_mysql
sakaik
0
180
変化する開発、進化する体系時代に適応するソフトウェアエンジニアの知識と考え方(JaSST'25 Kansai)
mizunori
1
210
急成長を支える基盤作り〜地道な改善からコツコツと〜 #cre_meetup
stefafafan
0
120
BrainPadプログラミングコンテスト記念LT会2025_社内イベント&問題解説
brainpadpr
1
160
エンジニア向け技術スタック情報
kauche
1
250
Liquid Glass革新とSwiftUI/UIKit進化
fumiyasac0921
0
190
米国国防総省のDevSecOpsライフサイクルをAWSのセキュリティサービスとOSSで実現
syoshie
2
1k
生成AIでwebアプリケーションを作ってみた
tajimon
2
140
ハノーバーメッセ2025座談会.pdf
iotcomjpadmin
0
160
20250625 Snowflake Summit 2025活用事例 レポート / Nowcast Snowflake Summit 2025 Case Study Report
kkuv
1
300
Featured
See All Featured
Unsuck your backbone
ammeep
671
58k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
29
2.7k
Become a Pro
speakerdeck
PRO
28
5.4k
Code Review Best Practice
trishagee
68
18k
Building Adaptive Systems
keathley
43
2.6k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
231
53k
Visualization
eitanlees
146
16k
GraphQLとの向き合い方2022年版
quramy
47
14k
Measuring & Analyzing Core Web Vitals
bluesmoon
7
490
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
53
2.8k
The Cult of Friendly URLs
andyhume
79
6.5k
Rails Girls Zürich Keynote
gr2m
94
14k
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!