![Page 1: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/1.jpg)
Creative ContentFor BETTER DEVELOPER EXPERIENCE
Tomomi Imura (@girlie_mac)
![Page 2: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/2.jpg)
日本語のスライドはこちら
https://goo.gl/RqsWuvhttps://slideshare.net/tomomi/Japanese-creative-technical-content-for-better-developer-experience
![Page 3: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/3.jpg)
@ girlie_mac
● dev relations at Slack● api.slack.com● advocate open web & technology● code JavaScript & Node.js● hack useless stuff● advisor at Code Chrysalis● Live in foggy San Francisco
tomomi imura
![Page 4: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/4.jpg)
@ girlie_mac
Where I Have Been Doing DevRel at:
Slack API Nexmo SMS, Voice, 2FA
API
HTML5 (W3C) & Windows Phone webOS Apps
PubNub Realtime API
![Page 5: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/5.jpg)
@ girlie_mac
I Write Articles on:
Technical editor for some books by:
![Page 6: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/6.jpg)
Awareness & Acquisition
![Page 7: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/7.jpg)
SearchTweets, newsletters, etc.
Word of mouth, on Slack, etc.
API, Platform, Framework, Tools, etc.
How Do Developers Find Your...
![Page 8: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/8.jpg)
@ girlie_mac
Awareness
If devs find your shiny new stuff passively on TechCrunch, ProductHunt, announcement / marketing blog, etc:
Sounds awesome!
![Page 9: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/9.jpg)
@ girlie_mac
Awareness & Acquisition
If devs find your use cases, and with even better, easy-to-follow tutorials for how to build them:
Sounds awesome! I may wanna try!
![Page 10: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/10.jpg)
@ girlie_mac
Get Devs Hands Dirty!
● Workshops ● Hackathons● Blog & Tutorials
○ Docs○ Videos & Screencasts○ Webinars
![Page 11: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/11.jpg)
@ girlie_mac
Get Devs Hands Dirty!
● Workshops ● Hackathons● Blog & Tutorials
○ Docs○ Videos & Screencasts○ Webinars
My focus!
![Page 12: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/12.jpg)
Make It Practical!
![Page 13: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/13.jpg)
@ girlie_mac
Practical & Fundamental
Tutorial examples:
● [Awesome API] 101● Beginner Guide of [Awesome API] ● Getting Started with [Awesome API] using [Node SDK]● How to Build To-Do App with [Awesome.JS Framework]● [Awesome API] Tips & Tricks● [Awesome API] Best Practice
![Page 14: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/14.jpg)
@ girlie_mac
![Page 15: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/15.jpg)
@ girlie_mac
![Page 16: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/16.jpg)
@ girlie_mac
![Page 17: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/17.jpg)
Make It Interesting!
![Page 18: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/18.jpg)
@ girlie_mac
Interesting Projects
Creative tutorials:
● Physical Slackbot● Twitter Visualization with D3.js● Building a Raspberry Pi Spy Cam● “Alexa, Call My Mom”● Gotta Catch’em All! PokémonGo Relatime Mapping
![Page 19: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/19.jpg)
@ girlie_macBrainstorming ideas
![Page 20: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/20.jpg)
@ girlie_mac
Project Types
● Purely fun○ Pokémon○ IoT - cat camera
● Targeting a community / Ecosystem○ JavaScript - e.g. React, Angular, D3○ MCU - e.g. Arduino, Raspberry Pi○ Web standards - HTML5○ Amazon Alexa
![Page 21: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/21.jpg)
@ girlie_mac
![Page 22: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/22.jpg)
@ girlie_mac
![Page 23: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/23.jpg)
@ girlie_mac https://medium.com/slack-developer-blog/building-a-sentiment-analysis-bot-with-ibm-watson-and-raspberry-pi-eeb399bb8803
![Page 24: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/24.jpg)
@ girlie_mac
Let Devs Adopt the Ideas
“Pokemon is not how we win the big $$$ companies”
“Don’t get me wrong. We are providing ideas”
![Page 25: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/25.jpg)
@ girlie_mac
Adopting the Ideas for Real Apps
{
id: 'pikachu-012',
lat: 37.7234,
lon: -122.472
}
{
id: 'taxi-012',
lat: 37.7234,
lon: -122.472
}
![Page 26: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/26.jpg)
Go Social
![Page 27: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/27.jpg)
@ girlie_mac
Get Carded on Social Media
3
1
1
2
![Page 28: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/28.jpg)
@ girlie_mac
It’s So META!
<!-- Twitter Card data (with a large image) -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Title Here">
<meta name="twitter:description" content="Page description">
<meta name="twitter:image" content="http://example.com/image.jpg">
<!-- FB Open Graph data -->
<meta property="og:title" content="Title Here">
<meta property="og:type" content="article">
<meta property="og:url" content="http://www.example.com/">
<meta property="og:image" content="http://example.com/image.jpg">
<meta property="og:description" content="Page description">
3
1
2
![Page 29: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/29.jpg)
@ girlie_mac
Developer-Focused Social Space
Newsletters
Code Samples & Demo
![Page 30: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/30.jpg)
Adoption & RetentionImproving Developer Experiences
![Page 31: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/31.jpg)
@ girlie_mac
User-Experience
User-Experience (UX) focuses on having a deep understanding of users, what they need, what they value, their abilities, and also their limitations.”
Source: usability.gov
“
![Page 32: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/32.jpg)
@ girlie_mac
User-Experience
User-Experience (UX) focuses on having a deep understanding of users, what they need, what they value, their abilities, and also their limitations.”
Source: usability.gov
“
![Page 33: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/33.jpg)
@ girlie_mac
Developer-Experience
Developer-Experience (DX) focuses on having a deep understanding of developers, what they need, what they value, their abilities, and also their limitations.”
Source: usability.gov
“
![Page 34: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/34.jpg)
@ girlie_machttps://twitter.com/wheelyweb/status/849969689388134400
![Page 36: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/36.jpg)
@ girlie_machttps://twitter.com/ryo_sasaki/status/560229808362102784
Coffee machine fiasco at 7-Eleven in Japan
![Page 37: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/37.jpg)
@ girlie_mac
Bad UX: User Reactions
1. Get confused2. Guess and fail3. Frustrated4. Repeat 2 - 35. Totally pissed off
![Page 38: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/38.jpg)
@ girlie_mac
Bad DX: Developer Reactions
1. Get confused of enigmatic API & Docs2. console.log(“wtf”) & get errors3. Frustrated4. Repeat 2 - 35. Totally pissed off
![Page 39: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/39.jpg)
@ girlie_mac
Poor Docs & Tuts DX Examples
● No documentation● Poor onboarding experience● Bad browsing experience, no ref links● No diagram, screenshot, picture etc.● Too complex● Too marketing-y (Stock photo of a businessman in suit?)● PDF everything (Docs != Whitepaper)
![Page 40: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/40.jpg)
@ girlie_mac
Open Source Survey by GitHub
http://opensourcesurvey.org/2017/
#1 problem!
![Page 41: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/41.jpg)
@ girlie_mac
Docs & Tuts Should be
● Navigable ● Practical and/or interesting● newbie-friendly
○ Prerequisite, How to set up○ onboarding with “Hello, world”○ Hands-on
● Including code samples (Gee, who doesn’t?)● Informative - doet your devs uninformed about dev tools & libs
![Page 42: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/42.jpg)
@ girlie_mac
User-Friendliness
https://twitter.com/kaz/status/757733261938298881
![Page 43: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/43.jpg)
@ girlie_mac
Developer-Friendliness
![Page 44: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/44.jpg)
@ girlie_mac
Slack API Doc (Even More) Kawaii-fy Project (j/k!)
![Page 45: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/45.jpg)
@ girlie_mac
TL;DR
● Write to attract developers○ Make them practical / interesting so they want to try
● Syndicate your content● Go social
○ Use the social media meta tags○ Dev-focused media
● Improve dev experience to keep devs engaged
![Page 46: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/46.jpg)
@ girlie_mac
Developer Experience Matters!really
![Page 47: [DevRelCon Tokyo 2017] Creative Technical Content for Better Developer Experience](https://reader030.vdocuments.pub/reader030/viewer/2022020314/5aaceb887f8b9a1f368b4871/html5/thumbnails/47.jpg)
@ girlie_mac
Thank you!
@girlie_mac
girliemac.com
github.com/girliemac
slideshare.net/tomomi
BY-SA