How can you help developers to meet their needs when visiting a developer portal? How can you improve Developer eXperience via documentation types? What developer marketing practices help to reduce API friction?
3. Content
Developer portals
Tasks to do
Developer eXperience
Reduce API friction & engage users
Documentation eXperience
Documentation types along the
developer journey stages
77. Benefits
when you
take care of
Developer
eXperience
Higher
perceived
API value
Higher API
usage
Less friction Engaged
API
advocates
Developer
eXperience
78. Downstream
dev journey
stages
Think about...
Documentation
components
Discover &
Research
Landing page focus & structure Landing page, blog
Evaluate
Trust signals
Try-out options, demos, samples
Blog articles, use cases,
worked examples,
changelog, legal docs
Get Started
Sign-up and API key/token provisioning process
Ask for feedback, let users commit
Interactive tools
Tutorials, how-tos,
concepts, SDKs, topic
guides
Develop &
Troubleshoot
Audience focused support,
interactive contact form
Interview users at events, ask for feedback
References, FAQs,
discussion forum
Celebrate
Let users cover niche problems
Celebrate active users, reward them
Organize events/hackathons
Blog articles,
community page, use
cases
Maintain
Trust signals
Audience focused info
Reveal future plans
Legal docs, changelog,
status page, community
page
Give users
what they
need
&
Improve
Developer
eXperience
79. Image, screenshot and other
attributions
Unsplash.com
Developer portals
ABN Amro, Adyen, Algolia, Amazon, Apigee,
Braintree, Capital One, CenturyLink, Chargify, Cisco,
Citi, Clearbit, Deutsche Bank, DigitalOcean, Dropbox, Dwolla,
Erste, Facebook, Google, Heroku, Instagram, Keen IO,
LinkedIn, MailChimp, Mailjet, Mapbox, MasterCard,
Nordea, PayPal, RapidAPI, Redgate, Slack, Spotify, Starling Bank,
Stripe, Twilio, Twitter, Visa.
Research results of Meng et al. (Merseburg University of Applied Sciences)
81. Downstream
dev journey
stages
Think about...
Documentation
components
Discover &
Research
Landing page focus & structure Landing page, blog
Evaluate
Trust signals
Try-out options, demos, samples
Blog articles, use cases,
worked examples,
changelog, legal docs
Get Started
Sign-up and API key/token provisioning process
Ask for feedback, let users commit
Interactive tools
Tutorials, how-tos,
concepts, SDKs, topic
guides
Develop &
Troubleshoot
Audience focused support,
interactive contact form
Interview users at events, ask for feedback
References, FAQs,
discussion forum
Celebrate
Let users cover niche problems
Celebrate active users, reward them
Organize events/hackathons
Blog articles,
community page, use
cases
Maintain
Trust signals
Audience focused info
Reveal future plans
Legal docs, changelog,
status page, community
page
Give users
what they
need
&
Improve
Developer
eXperience