The Developer Experience

The Developer Experience WHAT IT IS WHY IT MATTERS HOW TO MAKE IT NOT SUCK twitter.com/ pamelafox.org @pamelafox pamelafox@ http:// gmail.com

User Experience “The sum of all interactions and events, both positive and negative, between a user and a web site.” AKA “bla bla bla”

User Experience Do I want to use it? How do I sign up? How do I get started? How do I use it? How do I get help?

DO I WANT TO USE IT?

HOW DO I SIGN UP?

HOW DO I GET STARTED?

HOW DO I USE IT?

HOW DO I GET HELP?

DEVELOPER EXPERIENCE “The sum of all interactions and events, both positive and negative, between a developer and a library, tool, or API.”

DEVELOPER EXPERIENCE Do I want to use it? How do I sign up? How do I get started? How do I use it? How do I get help?

DO I WANT TO USE IT?

HOW DO I SIGN UP?

HOW DO I GET STARTED?

HOW DO I USE IT?

HOW DO I GET HELP?

why should you care?

Who are you? Developer Experience (Library, Tool, API, ...) PROVIDERS CONSUMERS

...who am I? Childhood University hood Now 2002 2006 2011 CONSUMER PROVIDER CONSUMER

why does DX matter? Bad Experience I have to use X. Bare Minimum Usage Low Barrier for Leaving

why does DX matter? Good Experience I like to use X. Innovative Usage External Evangelism

let’s break it down...

Do I want to use it?

Does it have the features I need? Documentation Interactive Explorer

Can I safely build a business on top of it? Licensing Pricing Stability

Case Studies

How do I sign up?

How do I sign up? Best answer: No signup! No key!

Automated Key Signup

Usage Dashboard

How do I get started?

Downloads for Every Environment

Client Libraries for Every Language

“Hello World” (From 0 to 60 in 15 minutes)

How do I use it? How do I learn how to use it? Do I enjoy using it?

How do I learn how to use it? Documentation Comprehensive Easy to Navigate Reference & Guide Easy to Search Running Code Feedback Loop

Documentation should be Comprehensive Every method, parameter, return value, defaults,implementation notes, errors, side effects, deprecation notices. When in doubt, document.

Documentation should include both Reference & Guide

Documentation should include Runnable Code

Documentation should be Easy to Navigate

Documentation should be Easy to Search

Documentation should be Easy to Search on Google, too

Do I enjoy using it? API Design Familiarity Compatibility Simplicity Debuggability

API Design: HTTP Familiarity Compatibility Use standards Support both (when it makes sense) JSON & XML. REST, RPC, OAuth. Simplicity Debuggability Don’t throttle. Give meaningful error messages. Most importantly: Never ever use SOAP.

How do I get help?

Forum Email & Feeds Stats & Badges !Spam

Issue Tracker Comments Votes Search Status Categories Notiﬁcation

THE EXPERIENCE CURVE

THE FEEDBACK LOOP ..should be inﬁnite..

Feedback Forms

Surveys QT Mozilla Add-Ons SDK Blackboard API Survey Survey

Usability Testing Did you complete the task? How hard was it? Would you recommend this API? What would have made the experience of using the API better? Whose API does it better than we do? AT&T Usability Testing

Paying Attention Twitter Conference Talks Blog posts Google Alerts

MAKEOVER TIME!

Google Maps API v2 v3 keys no keys! MVC architecture bloated library (smaller download) GMap, GMarker,... google.maps.* GPolygon(latlngs, strokeColor,strokeWeight, strokeOpacity, google.maps.Polygon(options) ﬁllColor, ﬁllOpacity, opts)

ZeptoJS

NOW WHAT?

providers: 1. Care I 2. Prioritize 3. Improve

CONSUMERS Thanks! It’d be great if you changed X. I’d use it more if it had feature Y. Thanks - look what I made with it!

The Developer Experience IT MATTERS LETS MAKE IT NOT SUCK for more... developerexperience.org developer-support-handbook.org @pamelafox

http://summit.atlassian.com	385
http://www.webteacher.ws	329
http://magnolia-staging.private.atlassian.com	4
http://qa-wac.atlassian.com	1
http://translate.googleusercontent.com	1
http://feeds.feedburner.com	1
http://a030bba359890263	1

The Developer Experience

by Atlassian Presentations on Jun 22, 2012

Accessibility

Categories

Upload Details

Usage Rights

7 Embeds 722

Statistics

The Developer Experience Presentation Transcript