Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
FIVE ELEMENTS
OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
#apidays
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
ARE YOU FAILING TO GROW YOUR
ECOSYSTEM, BECAUSE OF A
POOR DEVELO...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
Accessibility
• Design patterns
• Code style
• Unit tests
Popula...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
YOUR API IS AN INTERFACE TO
YOUR SERVICES AND DATA FOR
CLIENT DE...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
JEN LI
FRONT-END DEVELOPER
Computer science graduate | 3 years e...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
Product = API
Customers = DEVELOPERS
Store = DEVELOPER PORTAL
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
DIGITAL CUSTOMER LIFECYCLE
REACH
ABANDONMENT
REACTIVATION
ATTRIT...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
Jen will experience your portal,
whether you explicitly design
f...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
Which elements should we design
for in our Developer Portal, to ...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
GATHERING INSIGHT
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
1. APP GALLERY
A list of apps that showcase how your API could b...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
2. API PLAYGROUND
A page where developers can experiment and pla...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
3. QUICK START
A way for developers to get up and running with a...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
DEMO - PARSE.COM
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
4. DOCUMENTATION
A description of the APIs features, functionali...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
5. KILLER UX & VISUAL DESIGN
A well thought-out developer experi...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
THERE ARE MANY OTHER
ELEMENTS
COMMUNITY API STATUS PRICING APP M...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
YOUR DEVELOPER PORTAL IS WHERE YOU
SELL YOUR APIs TO CLIENT DEVE...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
ARE YOU FAILING TO GROW YOUR
ECOSYSTEM, BECAUSE OF A
POOR DEVELO...
FIVE ELEMENTS OF SUPERIOR
DEVELOPER PORTALS
@hadi_michael
KEY TAKEAWAYS
• You can influence developer decision making.
• D...
bTHANK YOU
@hadi_michael
For more information and these
slides please visit:
https://hadi.io/apidays
Upcoming SlideShare
Loading in …5
×

Five Elements of Superior Developer Portals

1,587 views

Published on

Are you failing to attract client developers and grow your ecosystem? Do you understand the human
influence a developer portal can have? Our industry dedicates so much attention to building stellar user
portals for clients, however regularly fails to deliver the same experiences on developer and API portals. We
have the power to do better. As API designers and developers, we have the opportunity to influence
developer experiences and decision making. In this talk, Hadi will explore the elements commonly found on
developer portals, and identify those that consistently contribute to superior developer experiences.

Published in: Internet
  • Be the first to comment

Five Elements of Superior Developer Portals

  1. 1. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael #apidays
  2. 2. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael ARE YOU FAILING TO GROW YOUR ECOSYSTEM, BECAUSE OF A POOR DEVELOPER PORTAL?
  3. 3. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael Accessibility • Design patterns • Code style • Unit tests Popularity • Stack Overflow posts • HackerNews arguments • Tutorials / Blog posts INTERFACE • Readme / Documentation • Developer tools • Feature list } Activity • Commits / issues • Release frequency • Maintainers MEI SYSTEM FOR UPACKING TECHNICAL DECISIONS INFLUENCED BY DEVELOPER PORTALS
  4. 4. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael YOUR API IS AN INTERFACE TO YOUR SERVICES AND DATA FOR CLIENT DEVELOPERS
  5. 5. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael JEN LI FRONT-END DEVELOPER Computer science graduate | 3 years experience Advocate for ES6 & modern web-standards | Loves chocolate Is not interested... CORPORATE POLITICS VERSIONING MANAGING LOAD Legacy systems SQL queries Server costs Is interested... LEARNING CURVE DOCUMENTATION LATENCY Debugging Throttling SDKs
  6. 6. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael Product = API Customers = DEVELOPERS Store = DEVELOPER PORTAL
  7. 7. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael DIGITAL CUSTOMER LIFECYCLE REACH ABANDONMENT REACTIVATION ATTRITION CHURN LOYALTY (Jim Sterne & Matt Cutler, 2000) ACQUISITION CONVERSION RETENTION
  8. 8. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael Jen will experience your portal, whether you explicitly design for that experience or not!
  9. 9. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael Which elements should we design for in our Developer Portal, to offer Jen a superior developer experience & improve Customer Lifecycle Value?
  10. 10. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael GATHERING INSIGHT
  11. 11. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael 1. APP GALLERY A list of apps that showcase how your API could be used. Key elements • Featured apps • List of existing customers • Case studies • Testimonials and success stories
  12. 12. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  13. 13. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  14. 14. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  15. 15. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael 2. API PLAYGROUND A page where developers can experiment and play with the API. Examples • API Explorer • Trial console • Mock API endpoints • Working sample code on CodePen | Plunker | JSBin
  16. 16. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  17. 17. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  18. 18. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  19. 19. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael 3. QUICK START A way for developers to get up and running with a useful application of your API. Examples • Quick custom build • Pre-configured SDK • Interactive tutorial
  20. 20. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael DEMO - PARSE.COM
  21. 21. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael 4. DOCUMENTATION A description of the APIs features, functionality and implementation. Key elements • API Overview • API declarations & descriptions • Best practices and ‘gotchas’ • Inline example code (that can be edited) • Tutorials | Screencasts | Videos from meetups
  22. 22. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  23. 23. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  24. 24. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  25. 25. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  26. 26. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael 5. KILLER UX & VISUAL DESIGN A well thought-out developer experience, complemented by creative design. Key elements • Information architecture • Subtle, but helpful interaction design • Visual design that highlights key features
  27. 27. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  28. 28. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael
  29. 29. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael THERE ARE MANY OTHER ELEMENTS COMMUNITY API STATUS PRICING APP MANAGEMENT COMPANY INFO Forums Blogs IRC Wiki documentation Stack Overflow tags Uptime Response time Current status Subscription info Cost calculators Comparison tablets Key provisioning Analytics Permissions About us Vision Product list
  30. 30. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael YOUR DEVELOPER PORTAL IS WHERE YOU SELL YOUR APIs TO CLIENT DEVELOPERS KILLER UX & VISUAL DESIGN ACQUISITION CONVERSION RETENTION APP GALLERY API PLAYGROUND QUICK START DOCUMENTATION
  31. 31. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael ARE YOU FAILING TO GROW YOUR ECOSYSTEM, BECAUSE OF A POOR DEVELOPER PORTAL?
  32. 32. FIVE ELEMENTS OF SUPERIOR DEVELOPER PORTALS @hadi_michael KEY TAKEAWAYS • You can influence developer decision making. • Developers will experience your portal, whether you design for it or not. • Take time to consider which elements are important to your client developers.
  33. 33. bTHANK YOU @hadi_michael For more information and these slides please visit: https://hadi.io/apidays

×