SlideShare une entreprise Scribd logo
1  sur  23
Télécharger pour lire hors ligne
Louis Debatte-Monroy
Source: Evans Data Corporation, 2019
Mary Thengvall, The business value of developer relations, Apress
Onaverage6.3peopleinvolvedinB2Bpurchasing
Confidential © 2019 TomTom
Personas are:
1. Stereotypes – but specific to your business and industry!
2. A great way to explain your audience to non-developers
3. A tool to align teams on a common understanding of who you are building for
4. Qualitative, not quantitative ≠ market segments
5. A never finished exercise!
A day in the life of…
Confidential © 2019 TomTom
• Basic portrait: name, age, gender, location they live and
work, family situation
• Professional attributes: job title, years of experience, type
of company they work for, decision power
• Likes and dislikes: at work and outside of work
• Goals and fears: what motivates them? What are they
afraid of or wanting to avoid? What are they trying to
achieve?
• Personality: extravert? Introvert? Detail oriented? Quick
and dirty? Self-learner? Professional? Curious? Focused?
Polyvalent? Specialist?
Confidential © 2019 TomTom
1. Plenty of canvases & templates available
2. Start with your own stereotypes, use your intuition and experience
3. Make it a team exercise. Use the Devs in your company as inspiration.
4. No right or wrong: avoid the Imposter Syndrome
5. Observe, observe, observe: their posts; their emails; their names; their locations;
their behavior, what they do on week-ends, where they hang out, their job titles
Confidential © 2019 TomTom
AN INTERNAL TOOL WITH AN EXTERNAL IMPACT
1. Build a deck introducing them and share it with every team you work with
2. Put posters on your office walls with your personas
3. Refer to them everyday, in every conversation, as if they were a friend
4. Build content with personas in mind! Always mention them in:
• Marketing briefings
• Web journeys and UX
• Product development
• PR briefings
• Pricing
From “Developers want…” to “What would Pam think of this”?
DeeJay the Hacker Bartosz the Engineer Davin the Founder Pam the PM
Confidential © 2019 TomTom
Simplified product overview
for Pam the PM
Exhaustive documentation
for Bartosz the Engineer
Is this a good company to work with?
Confidential © 2019 TomTom
• Focus on simplicity
• Credibility with brands
• High level descriptions
• Focus on visuals, demos
• No technical details, non
exhaustive
What’s under the hood of this tech?
Confidential © 2019 TomTom
• Focus on exhaustivity
• As detailed as possible
• Logical structure, consistency
• No visuals, gimmicks or distractions
Is this worth my time? What can I expect from this API?
Confidential © 2019 TomTom
• A convenient tool to test APIs with no
account, API key or strings attached
• Try different parameters and review
the response
• Great for personas that are curious or
have little time to invest
What’s the quickest way to build this?
Confidential © 2019 TomTom
• Examples of actual implementation of
your APIs
• Interactive, shows the most popular
use cases
• Offers code samples to copy-paste
• Links to popular tools like CodePen or
GitHub
DeeJay the Hacker Bartosz the Engineer Davin the Founder Pam the PM
You know you are on the right track when:
Confidential © 2019 TomTom
• Your colleagues refer to your personas in every day life
• You read a piece of content and immediately see who it was written for
• You meet a user and immediately think “She’s a classic [persona]”
• You notice some of the behaviors you had “predicted” in your personas
How to Tailor Your Developer Portal to Your Audience

Contenu connexe

Tendances

Why you need a Developer Relations team for your API
Why you need a Developer Relations team for your APIWhy you need a Developer Relations team for your API
Why you need a Developer Relations team for your APIPronovix
 
Voxxed days 2015-hakansaglam-codereview
Voxxed days 2015-hakansaglam-codereviewVoxxed days 2015-hakansaglam-codereview
Voxxed days 2015-hakansaglam-codereviewHakan Saglam
 
Starting Your First Job in the Software Industry: Tips and Tricks from Nakov
Starting Your First Job in the Software Industry: Tips and Tricks from NakovStarting Your First Job in the Software Industry: Tips and Tricks from Nakov
Starting Your First Job in the Software Industry: Tips and Tricks from NakovSvetlin Nakov
 
How to develop an API ecosystem in the fintech industry from the ground up
How to develop an API ecosystem in the fintech industry from the ground upHow to develop an API ecosystem in the fintech industry from the ground up
How to develop an API ecosystem in the fintech industry from the ground upPronovix
 
Why hire dedicated developers from concept open source
Why hire dedicated developers from concept open sourceWhy hire dedicated developers from concept open source
Why hire dedicated developers from concept open sourceConcept Open Source
 
Developers Hate Marketing! Driving API Adoption
Developers Hate Marketing! Driving API AdoptionDevelopers Hate Marketing! Driving API Adoption
Developers Hate Marketing! Driving API AdoptionApigee | Google Cloud
 
The UX of DX: User Testing in the Invisible World of APIs
The UX of DX: User Testing in the Invisible World of APIsThe UX of DX: User Testing in the Invisible World of APIs
The UX of DX: User Testing in the Invisible World of APIsPronovix
 
Developer Relations 101
Developer Relations 101Developer Relations 101
Developer Relations 101Felipe Pedroso
 
Who's using your API?
Who's using your API?Who's using your API?
Who's using your API?Bruno Pedro
 
GraphQL vs BFF: A critical perspective
GraphQL vs BFF: A critical perspectiveGraphQL vs BFF: A critical perspective
GraphQL vs BFF: A critical perspectivePronovix
 
What is API Product Management by PayPal Director of Product
What is API Product Management by PayPal Director of ProductWhat is API Product Management by PayPal Director of Product
What is API Product Management by PayPal Director of ProductProduct School
 
Layar Q&A 27th November 2014
Layar Q&A 27th November 2014Layar Q&A 27th November 2014
Layar Q&A 27th November 2014Layar
 
2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...
2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...
2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...Modern Workplace Conference Paris
 
Conversational Teams: Moving Fast at Scale | Rasa Summit 2021
Conversational Teams: Moving Fast at Scale | Rasa Summit 2021Conversational Teams: Moving Fast at Scale | Rasa Summit 2021
Conversational Teams: Moving Fast at Scale | Rasa Summit 2021Rasa Technologies
 
InfoBeans Capabilities Presentation Mobile Practice
InfoBeans Capabilities Presentation   Mobile PracticeInfoBeans Capabilities Presentation   Mobile Practice
InfoBeans Capabilities Presentation Mobile PracticeInfoBeans Technologies Ltd.
 
Lessons learned while developing with Sylius
Lessons learned while developing with SyliusLessons learned while developing with Sylius
Lessons learned while developing with SyliusAntonio Peric-Mazar
 
Developer Marketing - API Days
Developer Marketing - API DaysDeveloper Marketing - API Days
Developer Marketing - API DaysCaroline Lewko
 

Tendances (20)

Why you need a Developer Relations team for your API
Why you need a Developer Relations team for your APIWhy you need a Developer Relations team for your API
Why you need a Developer Relations team for your API
 
Voxxed days 2015-hakansaglam-codereview
Voxxed days 2015-hakansaglam-codereviewVoxxed days 2015-hakansaglam-codereview
Voxxed days 2015-hakansaglam-codereview
 
Starting Your First Job in the Software Industry: Tips and Tricks from Nakov
Starting Your First Job in the Software Industry: Tips and Tricks from NakovStarting Your First Job in the Software Industry: Tips and Tricks from Nakov
Starting Your First Job in the Software Industry: Tips and Tricks from Nakov
 
How to develop an API ecosystem in the fintech industry from the ground up
How to develop an API ecosystem in the fintech industry from the ground upHow to develop an API ecosystem in the fintech industry from the ground up
How to develop an API ecosystem in the fintech industry from the ground up
 
Why hire dedicated developers from concept open source
Why hire dedicated developers from concept open sourceWhy hire dedicated developers from concept open source
Why hire dedicated developers from concept open source
 
Developers Hate Marketing! Driving API Adoption
Developers Hate Marketing! Driving API AdoptionDevelopers Hate Marketing! Driving API Adoption
Developers Hate Marketing! Driving API Adoption
 
The UX of DX: User Testing in the Invisible World of APIs
The UX of DX: User Testing in the Invisible World of APIsThe UX of DX: User Testing in the Invisible World of APIs
The UX of DX: User Testing in the Invisible World of APIs
 
Developer Relations 101
Developer Relations 101Developer Relations 101
Developer Relations 101
 
Technoforth profile 1
Technoforth profile 1Technoforth profile 1
Technoforth profile 1
 
Who's using your API?
Who's using your API?Who's using your API?
Who's using your API?
 
GraphQL vs BFF: A critical perspective
GraphQL vs BFF: A critical perspectiveGraphQL vs BFF: A critical perspective
GraphQL vs BFF: A critical perspective
 
What is API Product Management by PayPal Director of Product
What is API Product Management by PayPal Director of ProductWhat is API Product Management by PayPal Director of Product
What is API Product Management by PayPal Director of Product
 
Layar Q&A 27th November 2014
Layar Q&A 27th November 2014Layar Q&A 27th November 2014
Layar Q&A 27th November 2014
 
2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...
2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...
2018-10-18 J2 5A - Professional dev low code no code dev and citizen develope...
 
Conversational Teams: Moving Fast at Scale | Rasa Summit 2021
Conversational Teams: Moving Fast at Scale | Rasa Summit 2021Conversational Teams: Moving Fast at Scale | Rasa Summit 2021
Conversational Teams: Moving Fast at Scale | Rasa Summit 2021
 
InfoBeans Capabilities Presentation Mobile Practice
InfoBeans Capabilities Presentation   Mobile PracticeInfoBeans Capabilities Presentation   Mobile Practice
InfoBeans Capabilities Presentation Mobile Practice
 
Lessons learned while developing with Sylius
Lessons learned while developing with SyliusLessons learned while developing with Sylius
Lessons learned while developing with Sylius
 
Nordic api
Nordic apiNordic api
Nordic api
 
Why software projects fail in 2021?
Why software projects fail in 2021?Why software projects fail in 2021?
Why software projects fail in 2021?
 
Developer Marketing - API Days
Developer Marketing - API DaysDeveloper Marketing - API Days
Developer Marketing - API Days
 

Similaire à How to Tailor Your Developer Portal to Your Audience

CONNECTWorking 202005 | Succeed when remote
CONNECTWorking 202005 | Succeed when remoteCONNECTWorking 202005 | Succeed when remote
CONNECTWorking 202005 | Succeed when remoteGTA Talents
 
Marketers Guide to India
Marketers Guide to IndiaMarketers Guide to India
Marketers Guide to IndiaHarsha MV
 
Digital IR Communications
Digital IR CommunicationsDigital IR Communications
Digital IR CommunicationsComprend
 
Digital IR Communications
Digital IR CommunicationsDigital IR Communications
Digital IR CommunicationsComprend
 
Applying Web 2.0 Concepts to Your Business
Applying Web 2.0 Concepts to Your BusinessApplying Web 2.0 Concepts to Your Business
Applying Web 2.0 Concepts to Your Businessdigitalev
 
Lean startup & customer development
Lean startup & customer developmentLean startup & customer development
Lean startup & customer developmentEmanuele Musa
 
Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)
Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)
Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)Hubbard One
 
Evaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small BusinessEvaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small BusinessSamepage
 
Build your Own Technology Roadmap!
Build your Own Technology Roadmap!Build your Own Technology Roadmap!
Build your Own Technology Roadmap!Sascha Wenninger
 
CP Consulting ROPO in practice: experiences and case studies
CP Consulting ROPO in practice: experiences and case studiesCP Consulting ROPO in practice: experiences and case studies
CP Consulting ROPO in practice: experiences and case studiesComarch
 
Making the most of your website
Making the most of your websiteMaking the most of your website
Making the most of your websiteAndy Lima
 
How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...
How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...
How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...Clément Delangue
 
Programmatic & Video: New Opportunities, New Challenges
Programmatic & Video: New Opportunities, New ChallengesProgrammatic & Video: New Opportunities, New Challenges
Programmatic & Video: New Opportunities, New ChallengesDigiday
 
The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...
The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...
The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...IIHEvents
 
Talent Communications in a Digital Age
Talent Communications in a Digital AgeTalent Communications in a Digital Age
Talent Communications in a Digital AgeN. Robert Johnson, APR
 
Brightalk Cloud and the marketing minefield
Brightalk   Cloud and the marketing minefieldBrightalk   Cloud and the marketing minefield
Brightalk Cloud and the marketing minefieldIan Moyse ☁
 
Innovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging funding
Innovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging fundingInnovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging funding
Innovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging fundingInvest Northern Ireland
 

Similaire à How to Tailor Your Developer Portal to Your Audience (20)

CONNECTWorking 202005 | Succeed when remote
CONNECTWorking 202005 | Succeed when remoteCONNECTWorking 202005 | Succeed when remote
CONNECTWorking 202005 | Succeed when remote
 
Cut Cost Preparing for App Development: The 4 Decisions
Cut Cost Preparing for App Development: The 4 Decisions Cut Cost Preparing for App Development: The 4 Decisions
Cut Cost Preparing for App Development: The 4 Decisions
 
Marketers Guide to India
Marketers Guide to IndiaMarketers Guide to India
Marketers Guide to India
 
Digital IR Communications
Digital IR CommunicationsDigital IR Communications
Digital IR Communications
 
Digital IR Communications
Digital IR CommunicationsDigital IR Communications
Digital IR Communications
 
On outsourcing
On outsourcingOn outsourcing
On outsourcing
 
Applying Web 2.0 Concepts to Your Business
Applying Web 2.0 Concepts to Your BusinessApplying Web 2.0 Concepts to Your Business
Applying Web 2.0 Concepts to Your Business
 
Lean startup & customer development
Lean startup & customer developmentLean startup & customer development
Lean startup & customer development
 
Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)
Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)
Mobile Mania: What You Need to Know to Kick-Start Your Strategy (UK)
 
Business strategy
Business strategy Business strategy
Business strategy
 
Evaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small BusinessEvaluating Collaboration Tools for Your Small Business
Evaluating Collaboration Tools for Your Small Business
 
Build your Own Technology Roadmap!
Build your Own Technology Roadmap!Build your Own Technology Roadmap!
Build your Own Technology Roadmap!
 
CP Consulting ROPO in practice: experiences and case studies
CP Consulting ROPO in practice: experiences and case studiesCP Consulting ROPO in practice: experiences and case studies
CP Consulting ROPO in practice: experiences and case studies
 
Making the most of your website
Making the most of your websiteMaking the most of your website
Making the most of your website
 
How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...
How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...
How 200,000 companies including Century 21, Intercom, Reputation Squad, Worka...
 
Programmatic & Video: New Opportunities, New Challenges
Programmatic & Video: New Opportunities, New ChallengesProgrammatic & Video: New Opportunities, New Challenges
Programmatic & Video: New Opportunities, New Challenges
 
The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...
The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...
The Difficult Questions Your Digital Strategist Wants You To Ask (And Some Th...
 
Talent Communications in a Digital Age
Talent Communications in a Digital AgeTalent Communications in a Digital Age
Talent Communications in a Digital Age
 
Brightalk Cloud and the marketing minefield
Brightalk   Cloud and the marketing minefieldBrightalk   Cloud and the marketing minefield
Brightalk Cloud and the marketing minefield
 
Innovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging funding
Innovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging fundingInnovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging funding
Innovation and R&D Escalator Workshop: Ronan Cunningham - Leveraging funding
 

Plus de Pronovix

By the time they're reading the docs, it's already too late
By the time they're reading the docs, it's already too lateBy the time they're reading the docs, it's already too late
By the time they're reading the docs, it's already too latePronovix
 
Optimizing Dev Portals with Analytics and Feedback
Optimizing Dev Portals with Analytics and FeedbackOptimizing Dev Portals with Analytics and Feedback
Optimizing Dev Portals with Analytics and FeedbackPronovix
 
Success metrics when launching your first developer portal
Success metrics when launching your first developer portalSuccess metrics when launching your first developer portal
Success metrics when launching your first developer portalPronovix
 
Documentation, APIs & AI
Documentation, APIs & AIDocumentation, APIs & AI
Documentation, APIs & AIPronovix
 
Making sense of analytics for documentation pages
Making sense of analytics for documentation pagesMaking sense of analytics for documentation pages
Making sense of analytics for documentation pagesPronovix
 
Feedback cycles and their role in improving overall developer experiences
Feedback cycles and their role in improving overall developer experiencesFeedback cycles and their role in improving overall developer experiences
Feedback cycles and their role in improving overall developer experiencesPronovix
 
GraphQL Isn't An Excuse To Stop Writing Docs
GraphQL Isn't An Excuse To Stop Writing DocsGraphQL Isn't An Excuse To Stop Writing Docs
GraphQL Isn't An Excuse To Stop Writing DocsPronovix
 
API Documentation For Web3
API Documentation For Web3API Documentation For Web3
API Documentation For Web3Pronovix
 
Why your API doesn’t solve my problem: A use case-driven API design
Why your API doesn’t solve my problem: A use case-driven API designWhy your API doesn’t solve my problem: A use case-driven API design
Why your API doesn’t solve my problem: A use case-driven API designPronovix
 
unREST among the docs
unREST among the docsunREST among the docs
unREST among the docsPronovix
 
Developing a best-in-class deprecation policy for your APIs
Developing a best-in-class deprecation policy for your APIsDeveloping a best-in-class deprecation policy for your APIs
Developing a best-in-class deprecation policy for your APIsPronovix
 
Annotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyone
Annotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyoneAnnotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyone
Annotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyonePronovix
 
What do developers do when it comes to understanding and using APIs?
What do developers do when it comes to understanding and using APIs?What do developers do when it comes to understanding and using APIs?
What do developers do when it comes to understanding and using APIs?Pronovix
 
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and ConfigurationsInclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and ConfigurationsPronovix
 
Creating API documentation for international communities
Creating API documentation for international communitiesCreating API documentation for international communities
Creating API documentation for international communitiesPronovix
 
One Developer Portal to Document Them All
One Developer Portal to Document Them AllOne Developer Portal to Document Them All
One Developer Portal to Document Them AllPronovix
 
Docs-as-Code: Evolving the API Documentation Experience
Docs-as-Code: Evolving the API Documentation ExperienceDocs-as-Code: Evolving the API Documentation Experience
Docs-as-Code: Evolving the API Documentation ExperiencePronovix
 
Developer journey - make it easy for devs to love your product
Developer journey - make it easy for devs to love your productDeveloper journey - make it easy for devs to love your product
Developer journey - make it easy for devs to love your productPronovix
 
Complexity is not complicatedness
Complexity is not complicatednessComplexity is not complicatedness
Complexity is not complicatednessPronovix
 
How cognitive biases and ranking can foster an ineffective architecture and d...
How cognitive biases and ranking can foster an ineffective architecture and d...How cognitive biases and ranking can foster an ineffective architecture and d...
How cognitive biases and ranking can foster an ineffective architecture and d...Pronovix
 

Plus de Pronovix (20)

By the time they're reading the docs, it's already too late
By the time they're reading the docs, it's already too lateBy the time they're reading the docs, it's already too late
By the time they're reading the docs, it's already too late
 
Optimizing Dev Portals with Analytics and Feedback
Optimizing Dev Portals with Analytics and FeedbackOptimizing Dev Portals with Analytics and Feedback
Optimizing Dev Portals with Analytics and Feedback
 
Success metrics when launching your first developer portal
Success metrics when launching your first developer portalSuccess metrics when launching your first developer portal
Success metrics when launching your first developer portal
 
Documentation, APIs & AI
Documentation, APIs & AIDocumentation, APIs & AI
Documentation, APIs & AI
 
Making sense of analytics for documentation pages
Making sense of analytics for documentation pagesMaking sense of analytics for documentation pages
Making sense of analytics for documentation pages
 
Feedback cycles and their role in improving overall developer experiences
Feedback cycles and their role in improving overall developer experiencesFeedback cycles and their role in improving overall developer experiences
Feedback cycles and their role in improving overall developer experiences
 
GraphQL Isn't An Excuse To Stop Writing Docs
GraphQL Isn't An Excuse To Stop Writing DocsGraphQL Isn't An Excuse To Stop Writing Docs
GraphQL Isn't An Excuse To Stop Writing Docs
 
API Documentation For Web3
API Documentation For Web3API Documentation For Web3
API Documentation For Web3
 
Why your API doesn’t solve my problem: A use case-driven API design
Why your API doesn’t solve my problem: A use case-driven API designWhy your API doesn’t solve my problem: A use case-driven API design
Why your API doesn’t solve my problem: A use case-driven API design
 
unREST among the docs
unREST among the docsunREST among the docs
unREST among the docs
 
Developing a best-in-class deprecation policy for your APIs
Developing a best-in-class deprecation policy for your APIsDeveloping a best-in-class deprecation policy for your APIs
Developing a best-in-class deprecation policy for your APIs
 
Annotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyone
Annotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyoneAnnotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyone
Annotate, Automate & Educate: Driving generated OpenAPI docs to benefit everyone
 
What do developers do when it comes to understanding and using APIs?
What do developers do when it comes to understanding and using APIs?What do developers do when it comes to understanding and using APIs?
What do developers do when it comes to understanding and using APIs?
 
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and ConfigurationsInclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
 
Creating API documentation for international communities
Creating API documentation for international communitiesCreating API documentation for international communities
Creating API documentation for international communities
 
One Developer Portal to Document Them All
One Developer Portal to Document Them AllOne Developer Portal to Document Them All
One Developer Portal to Document Them All
 
Docs-as-Code: Evolving the API Documentation Experience
Docs-as-Code: Evolving the API Documentation ExperienceDocs-as-Code: Evolving the API Documentation Experience
Docs-as-Code: Evolving the API Documentation Experience
 
Developer journey - make it easy for devs to love your product
Developer journey - make it easy for devs to love your productDeveloper journey - make it easy for devs to love your product
Developer journey - make it easy for devs to love your product
 
Complexity is not complicatedness
Complexity is not complicatednessComplexity is not complicatedness
Complexity is not complicatedness
 
How cognitive biases and ranking can foster an ineffective architecture and d...
How cognitive biases and ranking can foster an ineffective architecture and d...How cognitive biases and ranking can foster an ineffective architecture and d...
How cognitive biases and ranking can foster an ineffective architecture and d...
 

Dernier

Strategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a FresherStrategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a FresherRemote DBA Services
 
Artificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : UncertaintyArtificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : UncertaintyKhushali Kathiriya
 
AXA XL - Insurer Innovation Award Americas 2024
AXA XL - Insurer Innovation Award Americas 2024AXA XL - Insurer Innovation Award Americas 2024
AXA XL - Insurer Innovation Award Americas 2024The Digital Insurer
 
Exploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone ProcessorsExploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone Processorsdebabhi2
 
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot TakeoffStrategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoffsammart93
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...apidays
 
Apidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbu
Apidays Singapore 2024 - Modernizing Securities Finance by Madhu SubbuApidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbu
Apidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbuapidays
 
Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)wesley chun
 
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc
 
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc
 
Corporate and higher education May webinar.pptx
Corporate and higher education May webinar.pptxCorporate and higher education May webinar.pptx
Corporate and higher education May webinar.pptxRustici Software
 
Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...
Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...
Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...Jeffrey Haguewood
 
DBX First Quarter 2024 Investor Presentation
DBX First Quarter 2024 Investor PresentationDBX First Quarter 2024 Investor Presentation
DBX First Quarter 2024 Investor PresentationDropbox
 
Manulife - Insurer Transformation Award 2024
Manulife - Insurer Transformation Award 2024Manulife - Insurer Transformation Award 2024
Manulife - Insurer Transformation Award 2024The Digital Insurer
 
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...apidays
 
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...Miguel Araújo
 
Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin WoodPolkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin WoodJuan lago vázquez
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FMESafe Software
 
"I see eyes in my soup": How Delivery Hero implemented the safety system for ...
"I see eyes in my soup": How Delivery Hero implemented the safety system for ..."I see eyes in my soup": How Delivery Hero implemented the safety system for ...
"I see eyes in my soup": How Delivery Hero implemented the safety system for ...Zilliz
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...apidays
 

Dernier (20)

Strategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a FresherStrategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a Fresher
 
Artificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : UncertaintyArtificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : Uncertainty
 
AXA XL - Insurer Innovation Award Americas 2024
AXA XL - Insurer Innovation Award Americas 2024AXA XL - Insurer Innovation Award Americas 2024
AXA XL - Insurer Innovation Award Americas 2024
 
Exploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone ProcessorsExploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone Processors
 
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot TakeoffStrategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...
 
Apidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbu
Apidays Singapore 2024 - Modernizing Securities Finance by Madhu SubbuApidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbu
Apidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbu
 
Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)
 
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
 
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
 
Corporate and higher education May webinar.pptx
Corporate and higher education May webinar.pptxCorporate and higher education May webinar.pptx
Corporate and higher education May webinar.pptx
 
Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...
Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...
Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...
 
DBX First Quarter 2024 Investor Presentation
DBX First Quarter 2024 Investor PresentationDBX First Quarter 2024 Investor Presentation
DBX First Quarter 2024 Investor Presentation
 
Manulife - Insurer Transformation Award 2024
Manulife - Insurer Transformation Award 2024Manulife - Insurer Transformation Award 2024
Manulife - Insurer Transformation Award 2024
 
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...
 
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...
 
Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin WoodPolkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
 
"I see eyes in my soup": How Delivery Hero implemented the safety system for ...
"I see eyes in my soup": How Delivery Hero implemented the safety system for ..."I see eyes in my soup": How Delivery Hero implemented the safety system for ...
"I see eyes in my soup": How Delivery Hero implemented the safety system for ...
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
 

How to Tailor Your Developer Portal to Your Audience

  • 2. Source: Evans Data Corporation, 2019
  • 3. Mary Thengvall, The business value of developer relations, Apress
  • 4.
  • 5.
  • 7.
  • 8. Confidential © 2019 TomTom Personas are: 1. Stereotypes – but specific to your business and industry! 2. A great way to explain your audience to non-developers 3. A tool to align teams on a common understanding of who you are building for 4. Qualitative, not quantitative ≠ market segments 5. A never finished exercise!
  • 9. A day in the life of… Confidential © 2019 TomTom • Basic portrait: name, age, gender, location they live and work, family situation • Professional attributes: job title, years of experience, type of company they work for, decision power • Likes and dislikes: at work and outside of work • Goals and fears: what motivates them? What are they afraid of or wanting to avoid? What are they trying to achieve? • Personality: extravert? Introvert? Detail oriented? Quick and dirty? Self-learner? Professional? Curious? Focused? Polyvalent? Specialist?
  • 10. Confidential © 2019 TomTom 1. Plenty of canvases & templates available 2. Start with your own stereotypes, use your intuition and experience 3. Make it a team exercise. Use the Devs in your company as inspiration. 4. No right or wrong: avoid the Imposter Syndrome 5. Observe, observe, observe: their posts; their emails; their names; their locations; their behavior, what they do on week-ends, where they hang out, their job titles
  • 11. Confidential © 2019 TomTom AN INTERNAL TOOL WITH AN EXTERNAL IMPACT 1. Build a deck introducing them and share it with every team you work with 2. Put posters on your office walls with your personas 3. Refer to them everyday, in every conversation, as if they were a friend 4. Build content with personas in mind! Always mention them in: • Marketing briefings • Web journeys and UX • Product development • PR briefings • Pricing From “Developers want…” to “What would Pam think of this”?
  • 12.
  • 13. DeeJay the Hacker Bartosz the Engineer Davin the Founder Pam the PM
  • 14. Confidential © 2019 TomTom Simplified product overview for Pam the PM Exhaustive documentation for Bartosz the Engineer
  • 15. Is this a good company to work with? Confidential © 2019 TomTom • Focus on simplicity • Credibility with brands • High level descriptions • Focus on visuals, demos • No technical details, non exhaustive
  • 16. What’s under the hood of this tech? Confidential © 2019 TomTom • Focus on exhaustivity • As detailed as possible • Logical structure, consistency • No visuals, gimmicks or distractions
  • 17. Is this worth my time? What can I expect from this API? Confidential © 2019 TomTom • A convenient tool to test APIs with no account, API key or strings attached • Try different parameters and review the response • Great for personas that are curious or have little time to invest
  • 18. What’s the quickest way to build this? Confidential © 2019 TomTom • Examples of actual implementation of your APIs • Interactive, shows the most popular use cases • Offers code samples to copy-paste • Links to popular tools like CodePen or GitHub
  • 19.
  • 20.
  • 21. DeeJay the Hacker Bartosz the Engineer Davin the Founder Pam the PM
  • 22. You know you are on the right track when: Confidential © 2019 TomTom • Your colleagues refer to your personas in every day life • You read a piece of content and immediately see who it was written for • You meet a user and immediately think “She’s a classic [persona]” • You notice some of the behaviors you had “predicted” in your personas