Tweet
Tweet

Slide 1

Slide 1 text

Developer Experience May 23, 2̸17 betta.io

Slide 2

Slide 2 text

Welcome betta.io

Slide 3

Slide 3 text

Cristiano Betta DX Consultant @ Work Betta Ex-Dev Advocate @ Braintree betta.io

Slide 4

Slide 4 text

Cristiano Betta Event Organiser @ Geeks of London > 15 years dev experience betta.io

Slide 5

Slide 5 text

Maintainer of Hack Day Manifesto and Hack Code of Conduct betta.io

Slide 6

Slide 6 text

hackdaymanifesto.com

Slide 7

Slide 7 text

hackcodeofconduct.org

Slide 8

Slide 8 text

Author betta.io

Slide 9

Slide 9 text

betta.io

Slide 10

Slide 10 text

betta.io

Slide 11

Slide 11 text

@cbetta [email protected] betta.io

Slide 12

Slide 12 text

betta.io

Slide 13

Slide 13 text

Agenda betta.io

Slide 14

Slide 14 text

Agenda • Defining Developer Experience betta.io

Slide 15

Slide 15 text

Agenda • Defining Developer Experience • Developer Experience Journey betta.io

Slide 16

Slide 16 text

Agenda • Defining Developer Experience • Developer Experience Journey • Core Use Cases betta.io

Slide 17

Slide 17 text

Agenda • Defining Developer Experience • Developer Experience Journey • Core Use Cases • Break betta.io

Slide 18

Slide 18 text

Agenda • Defining Developer Experience • Developer Experience Journey • Core Use Cases • Break • Building Blocks betta.io

Slide 19

Slide 19 text

Agenda • Defining Developer Experience • Developer Experience Journey • Core Use Cases • Break • Building Blocks • Maturity Model betta.io

Slide 20

Slide 20 text

Agenda • Defining Developer Experience • Developer Experience Journey • Core Use Cases • Break • Building Blocks • Maturity Model • Content Matrix betta.io

Slide 21

Slide 21 text

Ask me anything betta.io

Slide 22

Slide 22 text

Developer Experience betta.io

Slide 23

Slide 23 text

What is DX? betta.io

Slide 24

Slide 24 text

“Developer experience is an extension of UX that focuses on the developer, who can either be the intermediary or, as is the case with many APIs, the end user. Whether or not you focus on DX design, your developers are always experiencing your API, and that experience may either be positive or negative.” betta.io - Jennifer Riggins | @jkriggins

Slide 25

Slide 25 text

A platform betta.io

Slide 26

Slide 26 text

A platform A successful user betta.io

Slide 27

Slide 27 text

A developer platform A successful developer

Slide 28

Slide 28 text

A developer platform A successful developer A fresh new developer

Slide 29

Slide 29 text

A developer platform A fresh new developer Long term success A successful developer

Slide 30

Slide 30 text

Developer Experience 1st site visit Successful integration Outreach Advocacy

Slide 31

Slide 31 text

Developer Experience 1st site visit Successful integration Advocacy Outreach Developer Outreach betta.io

Slide 32

Slide 32 text

Developer Experience 1st site visit Successful integration Advocacy Outreach • Hackathons Developer Outreach betta.io

Slide 33

Slide 33 text

Developer Experience 1st site visit Successful integration Advocacy Outreach • Hackathons • Conferences Developer Outreach betta.io

Slide 34

Slide 34 text

Developer Experience 1st site visit Successful integration Advocacy Outreach • Hackathons • Conferences • Talks Developer Outreach betta.io

Slide 35

Slide 35 text

Developer Experience 1st site visit Successful integration Advocacy Outreach • Hackathons • Conferences • Talks • Blog posts Developer Outreach betta.io

Slide 36

Slide 36 text

Developer Experience 1st site visit Successful integration Advocacy Outreach • Hackathons • Conferences • Talks • Blog posts • Tutorials Developer Outreach betta.io

Slide 37

Slide 37 text

Developer Experience 1st site visit Successful integration Outreach Advocacy

Slide 38

Slide 38 text

Developer Experience 1st site visit Successful integration Outreach Advocacy Developer Advocacy betta.io

Slide 39

Slide 39 text

Developer Experience 1st site visit Successful integration Outreach Advocacy • Support Developer Advocacy betta.io

Slide 40

Slide 40 text

Developer Experience 1st site visit Successful integration Outreach Advocacy • Support • Feedback Developer Advocacy betta.io

Slide 41

Slide 41 text

Developer Experience 1st site visit Successful integration Outreach Advocacy • Support • Feedback • Tooling Developer Advocacy betta.io

Slide 42

Slide 42 text

Developer Experience 1st site visit Successful integration Outreach Advocacy • Support • Feedback • Tooling • Office hours Developer Advocacy betta.io

Slide 43

Slide 43 text

Developer Experience 1st site visit Successful integration Outreach Advocacy • Support • Feedback • Tooling • Office hours • Beta Programmes Developer Advocacy betta.io

Slide 44

Slide 44 text

Developer Experience 1st site visit Successful integration Outreach Advocacy

Slide 45

Slide 45 text

APIs + SDKs Documentation betta.io

Slide 46

Slide 46 text

APIs + SDKs Documentation betta.io

Slide 47

Slide 47 text

APIs + SDKs Documentation + External Developers betta.io

Slide 48

Slide 48 text

Usability + External Developers betta.io

Slide 49

Slide 49 text

Usability betta.io

Slide 50

Slide 50 text

Discoverable Forgiving Learnable Correct Predictable Usability betta.io

Slide 51

Slide 51 text

Correct betta.io

Slide 52

Slide 52 text

No content

Slide 53

Slide 53 text

No content

Slide 54

Slide 54 text

Predictable betta.io

Slide 55

Slide 55 text

Cognitive Load betta.io

Slide 56

Slide 56 text

Delete betta.io

Slide 57

Slide 57 text

Delete... betta.io

Slide 58

Slide 58 text

What can I do? What will happen? Will I break anything? betta.io

Slide 59

Slide 59 text

No content

Slide 60

Slide 60 text

No content

Slide 61

Slide 61 text

No content

Slide 62

Slide 62 text

betta.io

Slide 63

Slide 63 text

betta.io

Slide 64

Slide 64 text

Discoverable betta.io

Slide 65

Slide 65 text

Where am I? What can I do? Where can I go? Where did I come from? betta.io

Slide 66

Slide 66 text

No content

Slide 67

Slide 67 text

betta.io

Slide 68

Slide 68 text

Forgiving betta.io

Slide 69

Slide 69 text

betta.io

Slide 70

Slide 70 text

betta.io

Slide 71

Slide 71 text

betta.io

Slide 72

Slide 72 text

Learnable betta.io

Slide 73

Slide 73 text

No content

Slide 74

Slide 74 text

Usability Discoverable Forgiving Learnable Correct Predictable betta.io

Slide 75

Slide 75 text

Usability betta.io

Slide 76

Slide 76 text

Usability + External Developers betta.io

Slide 77

Slide 77 text

External Developers betta.io

Slide 78

Slide 78 text

External Developers betta.io

Slide 79

Slide 79 text

Understanding Developers betta.io

Slide 80

Slide 80 text

Understanding Developers

Slide 81

Slide 81 text

Understanding Developers Documentation Types

Slide 82

Slide 82 text

Understanding Developers Documentation Types Developer Journey

Slide 83

Slide 83 text

Understanding Developers Documentation Types Developer Journey Building Blocks

Slide 84

Slide 84 text

Understanding Developers Documentation Types Developer Journey Building Blocks Content Matrix

Slide 85

Slide 85 text

Understanding Developers Documentation Types Developer Journey Building Blocks Content Matrix Maturity Model

Slide 86

Slide 86 text

Understanding Developers Documentation Types Developer Journey Building Blocks Content Matrix Maturity Model Success & Celebration

Slide 87

Slide 87 text

Understanding Developers betta.io

Slide 88

Slide 88 text

Understanding Developers betta.io

Slide 89

Slide 89 text

Understanding Developers • Enterprise Developers betta.io

Slide 90

Slide 90 text

Understanding Developers • Enterprise Developers • Startup Developers betta.io

Slide 91

Slide 91 text

Understanding Developers • Enterprise Developers • Startup Developers • Hackers betta.io

Slide 92

Slide 92 text

Understanding Developers • Enterprise Developers • Startup Developers • Hackers • Junior betta.io

Slide 93

Slide 93 text

Understanding Developers • Enterprise Developers • Startup Developers • Hackers • Junior • N00bs betta.io

Slide 94

Slide 94 text

Understanding Developers • Enterprise Developers • Startup Developers • Hackers • Junior • N00bs • Senior betta.io

Slide 95

Slide 95 text

Developer Attributes betta.io

Slide 96

Slide 96 text

Developer Attributes • Money? betta.io

Slide 97

Slide 97 text

Developer Attributes • Money? • Seniority? betta.io

Slide 98

Slide 98 text

Developer Attributes • Money? • Seniority? • Age? betta.io

Slide 99

Slide 99 text

Developer Attributes • Money? • Seniority? • Age? • Gender? betta.io

Slide 100

Slide 100 text

Educational Attributes betta.io

Slide 101

Slide 101 text

Educational Attributes • Product Experience betta.io

Slide 102

Slide 102 text

Educational Attributes • Product Experience • Industry Experience betta.io

Slide 103

Slide 103 text

Educational Attributes • Product Experience • Industry Experience • Technical Experience betta.io

Slide 104

Slide 104 text

Educational Attributes • Product Experience • Industry Experience • Technical Experience • Life Experience betta.io

Slide 105

Slide 105 text

Educational Attributes • Product Experience • Industry Experience • Technical Experience • Life Experience • Motivation betta.io

Slide 106

Slide 106 text

Educational Attributes • Experience • Motivation betta.io

Slide 107

Slide 107 text

Developer Journey Experience Motivation betta.io

Slide 108

Slide 108 text

Experience Motivation Your CTO Developer Journey betta.io

Slide 109

Slide 109 text

Experience Motivation Your CTO Newbie Developer Journey betta.io

Slide 110

Slide 110 text

Experience Motivation Your CTO Newbie Convert Developer Journey betta.io

Slide 111

Slide 111 text

Experience Motivation Your CTO Newbie Convert Try Now Developer Journey betta.io

Slide 112

Slide 112 text

Experience Motivation Your CTO Newbie Convert Try Now Impl. Developer Journey betta.io

Slide 113

Slide 113 text

Experience Motivation Expert Newbie Convert Try Now Impl. Developer Journey betta.io

Slide 114

Slide 114 text

Experience Motivation Developer Journey betta.io

Slide 115

Slide 115 text

Experience Motivation Developer Journey betta.io

Slide 116

Slide 116 text

Experience Motivation Developer Journey betta.io

Slide 117

Slide 117 text

Experience Motivation Developer Journey betta.io

Slide 118

Slide 118 text

Experience Motivation Developer Journey betta.io

Slide 119

Slide 119 text

Understanding Developers betta.io

Slide 120

Slide 120 text

Understanding Developers Documentation Types Developer Journey Building Blocks Content Matrix Maturity Model Success & Celebration

Slide 121

Slide 121 text

Documentation Types betta.io

Slide 122

Slide 122 text

Exercise betta.io

Slide 123

Slide 123 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 124

Slide 124 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 125

Slide 125 text

betta.io stripe.com/docs developer.github.com firebase.google.com What types of documentation can we recognise?

Slide 126

Slide 126 text

betta.io stripe.com/docs developer.github.com firebase.google.com What types of documentation can we recognise? For what level of experience and motivation is that documentation intended?

Slide 127

Slide 127 text

betta.io stripe.com/docs developer.github.com firebase.google.com What types of documentation can we recognise? For what level of experience and motivation is that documentation intended? How does the documentation flow from one type to the other? (Bonus)

Slide 128

Slide 128 text

betta.io stripe.com/docs developer.github.com firebase.google.com What types of documentation can we recognise? For what level of experience and motivation is that documentation intended? How does the documentation flow from one type to the other? (Bonus) Can you spot any problems in their Developer Experience? (Bonus)

Slide 129

Slide 129 text

No content

Slide 130

Slide 130 text

No content

Slide 131

Slide 131 text

No content

Slide 132

Slide 132 text

betta.io stripe.com/docs developer.github.com firebase.google.com What types of documentation can we recognise? For what level of experience and motivation is that documentation intended? How does the documentation flow from one type to the other? (Bonus) Can you spot any problems in their Developer Experience? (Bonus)

Slide 133

Slide 133 text

No content

Slide 134

Slide 134 text

No content

Slide 135

Slide 135 text

betta.io

Slide 136

Slide 136 text

betta.io

Slide 137

Slide 137 text

No content

Slide 138

Slide 138 text

No content

Slide 139

Slide 139 text

No content

Slide 140

Slide 140 text

No content

Slide 141

Slide 141 text

No content

Slide 142

Slide 142 text

No content

Slide 143

Slide 143 text

No content

Slide 144

Slide 144 text

Documentation Types betta.io

Slide 145

Slide 145 text

Documentation Types betta.io

Slide 146

Slide 146 text

Documentation Types betta.io • Get Started Guides

Slide 147

Slide 147 text

Documentation Types betta.io • Get Started Guides • QuickStarts

Slide 148

Slide 148 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials

Slide 149

Slide 149 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides

Slide 150

Slide 150 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples

Slide 151

Slide 151 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos

Slide 152

Slide 152 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference

Slide 153

Slide 153 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference • Use Cases

Slide 154

Slide 154 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference • Use Cases • Examples

Slide 155

Slide 155 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference • Use Cases • Examples • Libraries & SDKs

Slide 156

Slide 156 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference • Use Cases • Examples • Libraries & SDKs

Slide 157

Slide 157 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference • Use Cases • Examples • Libraries & SDKs

Slide 158

Slide 158 text

Documentation Types betta.io • Get Started Guides • QuickStarts • Tutorials • Guides • Samples • Demos • Reference • Use Cases • Examples • Libraries & SDKs

Slide 159

Slide 159 text

Documentation Types Experience Motivation betta.io

Slide 160

Slide 160 text

Experience Motivation betta.io

Slide 161

Slide 161 text

Reference Experience Motivation betta.io

Slide 162

Slide 162 text

Reference Exploration Experience Motivation betta.io

Slide 163

Slide 163 text

No content

Slide 164

Slide 164 text

No content

Slide 165

Slide 165 text

No content

Slide 166

Slide 166 text

Reference Exploration Experience Motivation betta.io

Slide 167

Slide 167 text

Getting Started Reference Exploration Experience Motivation betta.io

Slide 168

Slide 168 text

No content

Slide 169

Slide 169 text

No content

Slide 170

Slide 170 text

No content

Slide 171

Slide 171 text

No content

Slide 172

Slide 172 text

Further Guidance Getting Started Reference Exploration Experience Motivation betta.io

Slide 173

Slide 173 text

No content

Slide 174

Slide 174 text

Further Guidance Getting Started Reference Exploration Experience Motivation betta.io

Slide 175

Slide 175 text

Further Guidance Getting Started Reference Exploration Developer Journey

Slide 176

Slide 176 text

Understanding Developers Documentation Types Developer Journey

Slide 177

Slide 177 text

Understanding Developers Documentation Types Developer Journey Building Blocks

Slide 178

Slide 178 text

Core Use Cases betta.io

Slide 179

Slide 179 text

Money betta.io

Slide 180

Slide 180 text

Developer Experience 1st site visit Successful integration

Slide 181

Slide 181 text

Successful Integration

Slide 182

Slide 182 text

First implementation

Slide 183

Slide 183 text

First implementation

Slide 184

Slide 184 text

First implementation $$$

Slide 185

Slide 185 text

Core Use Case $$$

Slide 186

Slide 186 text

Core Use Cases betta.io

Slide 187

Slide 187 text

Core Use Cases • Sufficiently simple betta.io

Slide 188

Slide 188 text

Core Use Cases • Sufficiently simple • Relevant to a majority of integrations betta.io

Slide 189

Slide 189 text

Core Use Cases • Sufficiently simple • Relevant to a majority of integrations • Minimal overlap betta.io

Slide 190

Slide 190 text

Exercise betta.io

Slide 191

Slide 191 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 192

Slide 192 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 193

Slide 193 text

betta.io stripe.com/docs developer.github.com firebase.google.com What features are presented most prominently?

Slide 194

Slide 194 text

betta.io stripe.com/docs developer.github.com firebase.google.com What features are presented most prominently? What use cases are presented most prominently?

Slide 195

Slide 195 text

betta.io stripe.com/docs developer.github.com firebase.google.com What features are presented most prominently? What use cases are presented most prominently? What do you think their core use cases are? (Bonus)

Slide 196

Slide 196 text

betta.io stripe.com/docs developer.github.com firebase.google.com What features are presented most prominently? What use cases are presented most prominently? What do you think their core use cases are? (Bonus) Do you think they picked the right use cases? (Bonus)

Slide 197

Slide 197 text

No content

Slide 198

Slide 198 text

No content

Slide 199

Slide 199 text

No content

Slide 200

Slide 200 text

No content

Slide 201

Slide 201 text

No content

Slide 202

Slide 202 text

No content

Slide 203

Slide 203 text

No content

Slide 204

Slide 204 text

No content

Slide 205

Slide 205 text

No content

Slide 206

Slide 206 text

No content

Slide 207

Slide 207 text

betta.io stripe.com/docs developer.github.com firebase.google.com What features are presented most prominently? What use cases are presented most prominently? What do you think their core use cases are? (Bonus) Do you think they picked the right use cases? (Bonus)

Slide 208

Slide 208 text

No content

Slide 209

Slide 209 text

No content

Slide 210

Slide 210 text

betta.io

Slide 211

Slide 211 text

betta.io

Slide 212

Slide 212 text

betta.io • Charge a customer money once

Slide 213

Slide 213 text

betta.io • Charge a customer money once • Charge a customer money with a subscription

Slide 214

Slide 214 text

No content

Slide 215

Slide 215 text

No content

Slide 216

Slide 216 text

No content

Slide 217

Slide 217 text

betta.io

Slide 218

Slide 218 text

betta.io • Get data from, and push data to GitHub

Slide 219

Slide 219 text

betta.io • Get data from, and push data to GitHub • Get notified when data changes on GitHub

Slide 220

Slide 220 text

betta.io • Get data from, and push data to GitHub • Get notified when data changes on GitHub • Integrate with the GitHub.com UI

Slide 221

Slide 221 text

No content

Slide 222

Slide 222 text

No content

Slide 223

Slide 223 text

No content

Slide 224

Slide 224 text

betta.io

Slide 225

Slide 225 text

betta.io

Slide 226

Slide 226 text

betta.io • Log events

Slide 227

Slide 227 text

betta.io • Log events • Analyse log

Slide 228

Slide 228 text

betta.io • Log events • Analyse log • Manage users

Slide 229

Slide 229 text

betta.io • Log events • Analyse log • Manage users • Log in users

Slide 230

Slide 230 text

betta.io • Log events • Analyse log • Manage users • Log in users • ….

Slide 231

Slide 231 text

betta.io • Log events • Analyse log • Manage users • Log in users • …. • ….

Slide 232

Slide 232 text

betta.io @cbetta

Slide 233

Slide 233 text

betta.io @cbetta

Slide 234

Slide 234 text

Coffee Break betta.io @cbetta

Slide 235

Slide 235 text

Agenda • Defining Developer Experience • Developer Experience Journey • Core Use Cases • Break • Building Blocks • Maturity Model • Content Matrix betta.io

Slide 236

Slide 236 text

Understanding Developers Documentation Types Developer Journey Building Blocks Content Matrix Maturity Model Success & Celebration

Slide 237

Slide 237 text

Building Blocks betta.io

Slide 238

Slide 238 text

Mental Models betta.io

Slide 239

Slide 239 text

Mental Models Information betta.io

Slide 240

Slide 240 text

Mental Models betta.io

Slide 241

Slide 241 text

Mental Models betta.io

Slide 242

Slide 242 text

Mental Models betta.io

Slide 243

Slide 243 text

Mental Models betta.io

Slide 244

Slide 244 text

Mental Models betta.io

Slide 245

Slide 245 text

How We Learn • Learn • Build • Reflect betta.io

Slide 246

Slide 246 text

How We Learn • Learn • Build • Reflect betta.io

Slide 247

Slide 247 text

How We Learn ? betta.io

Slide 248

Slide 248 text

How we reflect betta.io

Slide 249

Slide 249 text

How we reflect • Minimise ability to deviate betta.io

Slide 250

Slide 250 text

How we reflect • Minimise ability to deviate • Provide checkpoints betta.io

Slide 251

Slide 251 text

How we reflect • Minimise ability to deviate • Provide checkpoints • Support user error betta.io

Slide 252

Slide 252 text

How we reflect betta.io

Slide 253

Slide 253 text

How we reflect • Small steps… betta.io

Slide 254

Slide 254 text

How we reflect • Small steps… • …that clearly document the expected output betta.io

Slide 255

Slide 255 text

How we reflect • Small steps… • …that clearly document the expected output • …and document common mistakes betta.io

Slide 256

Slide 256 text

Building Blocks

Slide 257

Slide 257 text

Building Blocks Encrypted Communication Use Case #1

Slide 258

Slide 258 text

Building Blocks Encrypted Communication Use Case #1 Encrypted Storage Use Case #2

Slide 259

Slide 259 text

Building Blocks Initialization Use Case #1 Initialization Use Case #2 Encrypted Communication Encrypted Storage

Slide 260

Slide 260 text

Building Blocks Initialization Use Case #1 Initialization Use Case #2 Encrypted Communication Encrypted Storage Create Keys for Alice Create Keys for Bob Create Keys for Alice

Slide 261

Slide 261 text

Building Blocks Initialization Encrypted Comms Initialization Encrypted Storage Create Keys for Alice Create Keys for Bob Create Keys for Alice Encrypt (for Bob) Decrypt (as Bob) Encrypt (for Alice) Decrypt (as Alice)

Slide 262

Slide 262 text

Building Blocks Installation Initialization Create Keys Create Cards Find Cards Encrypt Decrypt Sign Verify Primary betta.io

Slide 263

Slide 263 text

Building Blocks Installation Initialization Create Keys Create Cards Find Cards Encrypt Decrypt Sign Verify Primary Storing Keys Loading Keys Multi Encrypt Secondary betta.io

Slide 264

Slide 264 text

Exercise betta.io

Slide 265

Slide 265 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 266

Slide 266 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 267

Slide 267 text

betta.io stripe.com/docs developer.github.com firebase.google.com What building blocks can the core use cases be split into?

Slide 268

Slide 268 text

betta.io stripe.com/docs developer.github.com firebase.google.com What building blocks can the core use cases be split into? What secondary building blocks exist?

Slide 269

Slide 269 text

betta.io stripe.com/docs developer.github.com firebase.google.com What building blocks can the core use cases be split into? What secondary building blocks exist? • Charge a customer money once • Charge a customer money with a subscription

Slide 270

Slide 270 text

betta.io stripe.com/docs developer.github.com firebase.google.com What building blocks can the core use cases be split into? What secondary building blocks exist? • Charge a customer money once • Charge a customer money with a subscription • Get data from, and push data to GitHub • Get notified when data changes on GitHub • Integrate with the GitHub.com UI

Slide 271

Slide 271 text

betta.io stripe.com/docs developer.github.com firebase.google.com What building blocks can the core use cases be split into? What secondary building blocks exist? • Charge a customer money once • Charge a customer money with a subscription • Get data from, and push data to GitHub • Get notified when data changes on GitHub • Integrate with the GitHub.com UI • Register a new user • Login an existing user • Login an anonymous user

Slide 272

Slide 272 text

API/SDK Design betta.io

Slide 273

Slide 273 text

Problematic API/SDK betta.io

Slide 274

Slide 274 text

betta.io

Slide 275

Slide 275 text

betta.io Install SDK

Slide 276

Slide 276 text

betta.io Install SDK Initialize SDK

Slide 277

Slide 277 text

betta.io Install SDK Initialize SDK Charge Card

Slide 278

Slide 278 text

betta.io

Slide 279

Slide 279 text

betta.io gem install stripe

Slide 280

Slide 280 text

betta.io gem install stripe stripe = Stripe.new(‘username’, ‘password’)

Slide 281

Slide 281 text

betta.io gem install stripe stripe = Stripe.new(‘username’, ‘password’) stripe.charge(’card_number’, ‘cvv’, ‘amount’)

Slide 282

Slide 282 text

betta.io Install SDK Initialize SDK Charge Card

Slide 283

Slide 283 text

betta.io Install SDK Initialize SDK

Slide 284

Slide 284 text

betta.io Install SDK Initialize SDK Create a Customer

Slide 285

Slide 285 text

betta.io Install SDK Initialize SDK Create a Customer Save a card for a customer

Slide 286

Slide 286 text

betta.io Install SDK Initialize SDK Create a Customer Save a card for a customer Charge a customer

Slide 287

Slide 287 text

betta.io gem install stripe stripe = Stripe.new(‘username’, ‘password’) customer = stripe.customer.create(‘name’) customer.cards.create(’card_number’, ‘cvv’) customer.charge(‘amount’)

Slide 288

Slide 288 text

betta.io gem install stripe stripe = Stripe.new(‘username’, ‘password’) stripe.customer.createAndCharge(_)

Slide 289

Slide 289 text

Problematic Documentation betta.io

Slide 290

Slide 290 text

betta.io stripe = Stripe.new(‘appId’, ‘appSecret’)

Slide 291

Slide 291 text

betta.io stripe = Stripe.new(‘appId’, ‘appSecret’) create new “app” on site

Slide 292

Slide 292 text

betta.io

Slide 293

Slide 293 text

betta.io

Slide 294

Slide 294 text

betta.io send a sms from number buy a phone number

Slide 295

Slide 295 text

betta.io send a sms from number find a number log in to site copy number into code go to site Buy a number

Slide 296

Slide 296 text

betta.io send a sms from number copy number into code > nexmo number:buy US 1312* --confirm

Slide 297

Slide 297 text

betta.io

Slide 298

Slide 298 text

betta.io Building Blocks

Slide 299

Slide 299 text

Understanding Developers Documentation Types Developer Journey Building Blocks Content Matrix Maturity Model Success & Celebration

Slide 300

Slide 300 text

betta.io Content Matrix

Slide 301

Slide 301 text

betta.io Content Matrix

Slide 302

Slide 302 text

betta.io Exploration Content Matrix

Slide 303

Slide 303 text

betta.io Exploration Get Started Content Matrix

Slide 304

Slide 304 text

betta.io Exploration Get Started Guides Content Matrix

Slide 305

Slide 305 text

betta.io Exploration Get Started Guides Reference Content Matrix

Slide 306

Slide 306 text

betta.io Exploration Get Started Guides Reference Content Matrix

Slide 307

Slide 307 text

betta.io Exploration Get Started Guides Reference Content Matrix Install

Slide 308

Slide 308 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize

Slide 309

Slide 309 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys

Slide 310

Slide 310 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards

Slide 311

Slide 311 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards

Slide 312

Slide 312 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards

Slide 313

Slide 313 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt

Slide 314

Slide 314 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt

Slide 315

Slide 315 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign

Slide 316

Slide 316 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify

Slide 317

Slide 317 text

Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify

Slide 318

Slide 318 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify

Slide 319

Slide 319 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅

Slide 320

Slide 320 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅

Slide 321

Slide 321 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅

Slide 322

Slide 322 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅

Slide 323

Slide 323 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❎ ❎ ❎ ❎ ❎ ❎

Slide 324

Slide 324 text

betta.io Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❎ ❎ ❎ ❎ ❎ ❎ ✅ ✅

Slide 325

Slide 325 text

Exploration Get Started Guides Reference Content Matrix Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❎ ❎ ❎ ❎ ❎ ❎ ✅ ✅ Store Keys

Slide 326

Slide 326 text

betta.io Why?

Slide 327

Slide 327 text

Exploration Get Started Guides Reference All we need is Reference Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ Store Keys ✅

Slide 328

Slide 328 text

Exploration Get Started Guides Reference We wrote a tutorial Install Initialize Create Keys Create Cards Register Cards Find Cards Encrypt Decrypt Sign Verify ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ Store Keys

Slide 329

Slide 329 text

betta.io A Content Matrix is a tool

Slide 330

Slide 330 text

Maturity Model betta.io

Slide 331

Slide 331 text

Richardson Maturity Model betta.io

Slide 332

Slide 332 text

betta.io

Slide 333

Slide 333 text

betta.io GET /api/paymentProviderService { ‘type’ : ‘CustomerRequest’ ‘name’ : ‘Cristiano Betta’ } Level ̸

Slide 334

Slide 334 text

betta.io GET /api/customers?name=Cristiano%20Betta Level 1

Slide 335

Slide 335 text

betta.io GET /api/customers/create?name=Cristiano%20Betta Level 1

Slide 336

Slide 336 text

betta.io POST /api/customers { ‘name’ : ‘Cristiano Betta’ } Level 2

Slide 337

Slide 337 text

betta.io PUT /api/customers/123 { ‘name’ : ‘Cristiano Ronaldo’ } Level 2

Slide 338

Slide 338 text

betta.io GET /api/customers/123 { ‘name’ : ‘Cristiano Ronaldo’ } Level 2

Slide 339

Slide 339 text

betta.io GET /api/customers/123 { ‘name’ : ‘Cristiano Ronaldo’, ‘links’ : [ { ‘rel’ : ‘cards’, ‘uri’ : ‘/api/customers/123/cards`, ‘method’ : ‘GET’ ] } Level 3

Slide 340

Slide 340 text

betta.io

Slide 341

Slide 341 text

betta.io

Slide 342

Slide 342 text

betta.io 1. Reduce complexity

Slide 343

Slide 343 text

betta.io 1. Reduce complexity 2. Increase reusability

Slide 344

Slide 344 text

betta.io 1. Reduce complexity 2. Increase reusability 3. Introduce discoverability

Slide 345

Slide 345 text

Document Maturity Model betta.io

Slide 346

Slide 346 text

1: Reduce Complexity by using the four documentation types betta.io

Slide 347

Slide 347 text

No content

Slide 348

Slide 348 text

No content

Slide 349

Slide 349 text

2: Increase reusability by ensuring building blocks are individually accessible in any documentation type betta.io

Slide 350

Slide 350 text

No content

Slide 351

Slide 351 text

stripe.com/docs/api#create_charge betta.io

Slide 352

Slide 352 text

stripe.com/docs/charges#updating-saved-card-information betta.io

Slide 353

Slide 353 text

3: Introduce discoverability by linking to related topics in the same documentation level or the same topic at other levels betta.io

Slide 354

Slide 354 text

betta.io

Slide 355

Slide 355 text

betta.io

Slide 356

Slide 356 text

betta.io

Slide 357

Slide 357 text

betta.io

Slide 358

Slide 358 text

Exercise betta.io

Slide 359

Slide 359 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 360

Slide 360 text

betta.io stripe.com/docs developer.github.com firebase.google.com

Slide 361

Slide 361 text

betta.io stripe.com/docs developer.github.com firebase.google.com What UI patterns have been used to address these 3 levels?

Slide 362

Slide 362 text

betta.io stripe.com/docs developer.github.com firebase.google.com What UI patterns have been used to address these 3 levels? What overall level would you rate their documentation at?

Slide 363

Slide 363 text

betta.io stripe.com/docs developer.github.com firebase.google.com 1: Reduce Complexity by using the four documentation types What UI patterns have been used to address these 3 levels? What overall level would you rate their documentation at?

Slide 364

Slide 364 text

betta.io stripe.com/docs developer.github.com firebase.google.com 1: Reduce Complexity by using the four documentation types 2: Increase reusability by ensuring building blocks are individually accessible in any documentation type What UI patterns have been used to address these 3 levels? What overall level would you rate their documentation at?

Slide 365

Slide 365 text

betta.io stripe.com/docs developer.github.com firebase.google.com 1: Reduce Complexity by using the four documentation types 2: Increase reusability by ensuring building blocks are individually accessible in any documentation type 3: Introduce discoverability by linking to related topics in the same documentation level or the same topic at other levels What UI patterns have been used to address these 3 levels? What overall level would you rate their documentation at?

Slide 366

Slide 366 text

Celebration betta.io

Slide 367

Slide 367 text

Experience Motivation Developer Journey betta.io

Slide 368

Slide 368 text

Core Use Cases $$$

Slide 369

Slide 369 text

Success? betta.io

Slide 370

Slide 370 text

Signup? betta.io

Slide 371

Slide 371 text

First implementation? betta.io

Slide 372

Slide 372 text

Full integration? betta.io

Slide 373

Slide 373 text

Customer Success == Your Success betta.io

Slide 374

Slide 374 text

Make your customers successful betta.io

Slide 375

Slide 375 text

Supporting Success betta.io

Slide 376

Slide 376 text

Supporting Success betta.io • Alpha/Beta Programs

Slide 377

Slide 377 text

Supporting Success betta.io • Alpha/Beta Programs • Startup Programs

Slide 378

Slide 378 text

Supporting Success betta.io • Alpha/Beta Programs • Startup Programs • Customer Satisfaction Survey (NPS)

Slide 379

Slide 379 text

Supporting Success betta.io • Alpha/Beta Programs • Startup Programs • Customer Satisfaction Survey (NPS) • Non-core services

Slide 380

Slide 380 text

Stripe Atlas betta.io

Slide 381

Slide 381 text

Celebration betta.io

Slide 382

Slide 382 text

IKEA Effect betta.io

Slide 383

Slide 383 text

Reverse IKEA Effect betta.io

Slide 384

Slide 384 text

Developing an integration is a collaboration betta.io

Slide 385

Slide 385 text

Celebrate together betta.io

Slide 386

Slide 386 text

betta.io

Slide 387

Slide 387 text

Recap betta.io

Slide 388

Slide 388 text

DX is where your product and external developers collide betta.io

Slide 389

Slide 389 text

External developers can be characterised by experience and motivation betta.io

Slide 390

Slide 390 text

Most of the DX happens in four phases betta.io

Slide 391

Slide 391 text

Exploration Getting Started Further Guidance Reference betta.io

Slide 392

Slide 392 text

The most common ways your product enables a developer to succeed define your Core Use Cases betta.io

Slide 393

Slide 393 text

Shared elements between your Core Use Cases define your Building Blocks betta.io

Slide 394

Slide 394 text

Your Building Blocks and the 4 documentation types allow you to fill a Content Matrix betta.io

Slide 395

Slide 395 text

The DX can be enhanced with the help of a the Documentation Maturity Model betta.io

Slide 396

Slide 396 text

A successful customer should be celebrated as if it was a success of your own betta.io

Slide 397

Slide 397 text

Understanding Developers & Documentation Types Developer Journey & Building Blocks Content Matrix Maturity Model Celebration

Slide 398

Slide 398 text

Questions betta.io

Slide 399

Slide 399 text

FAQ betta.io

Slide 400

Slide 400 text

Which company does this the best? betta.io

Slide 401

Slide 401 text

Experience Motivation betta.io

Slide 402

Slide 402 text

Stripe Experience Motivation betta.io

Slide 403

Slide 403 text

No content

Slide 404

Slide 404 text

Stripe Twilio Experience Motivation betta.io

Slide 405

Slide 405 text

No content

Slide 406

Slide 406 text

Pusher Stripe Twilio Experience Motivation betta.io

Slide 407

Slide 407 text

No content

Slide 408

Slide 408 text

Twilio??? Pusher Stripe Twilio Experience Motivation betta.io

Slide 409

Slide 409 text

No content

Slide 410

Slide 410 text

How do I measure ROI? betta.io

Slide 411

Slide 411 text

Measure Change betta.io

Slide 412

Slide 412 text

betta.io

Slide 413

Slide 413 text

Measure Success betta.io

Slide 414

Slide 414 text

Should I own my SDKs? betta.io

Slide 415

Slide 415 text

How can you determine the DX of something you don’t own? betta.io

Slide 416

Slide 416 text

No content

Slide 417

Slide 417 text

Tooling? betta.io

Slide 418

Slide 418 text

Questions betta.io

Slide 419

Slide 419 text

Thank you crist[email protected] betta.io