SlideShare ist ein Scribd-Unternehmen logo
1 von 44
Downloaden Sie, um offline zu lesen
Product
Recommendations
for Teams Dev-Docs
by Utsav Parashar
Vision & Objective
Company Mission (for
developers)
“to empower every developer and every dev based
organization on the planet to achieve more.”
Teams Platform Vision
“to provide a single hub for teamwork in Office 365
since teamwork is essential to the way work gets done
today.”
Objective of Teams Dev
Docs
“to get the developers off the Dev docs as soon as
possible so that they can start building apps.”
Competitor Analysis
(Teams Dev Docs)
Launched
No. of Third Party
Apps
No. of
Developers
Slack 2013 1,800 600,000
Microsoft
Teams
2017 500+ Initial Stages
Zoom 2011 700+ N/A
Slack API Docs (First Fold)
Teams API Docs (First Fold)
Development Stages & Pain Points
Stage of Development Awareness Discovery Learning Implementation Debugging
Developer Pain Points
Not sure about
which platform to
choose and why
What are the
documents that would
help me resolve my
questions
How to get overview
of the platform
capabilities/
integrations
How to quickly
integrate sample code
Find out common errors
and their solutions
Role of Teams Dev Docs
(Dev Level: Beginner)
N/A
Be easily discoverable
on Search engines,
prompt the user to
learn more
Discover what are the
areas that the
Developer is weak in,
provide tutorials
Step by step guide to
impelmentation,
providing support
whereever necessary
List out the most
common errors and
provide support in case
the Dev is unable to
proceed
Role of Teams Dev Docs
(Dev Level: Intermediate)
Introduction to the
Teams platform
capabilities
Be easily discoverable
on Search engines,
prompt the user to try
code
N/A
Provide a way to test
out the APIs and its
request/response data
Provide support and a
way to connect with
experts
Role of Teams Dev Docs
(Dev Level: Advanced)
Why the
developers must
choose to build on
Teams platform
over other
platforms
N/A N/A
Provide sample code
and other resourses as
quickly as possible
Incentivize them to
contribute to the
Developer forums
Gap Analysis (Assumption)
Business Objective User Problem (Gap Analysis) Product Stage Metric to be moved
Create a large developer
community for Teams
platform
Find out relevent content as
quickly as possible
Adoption
Time spent on Dev docs must
be reduced by 30% while
keeping the #New Developers
increasing
Call out - Assumption needs to be validated using extensive user-study (& MVP experiments)
Business Objective User Problem (Gap Analysis) Product Stage Metric to be moved
Create a large developer
community for Teams
platform
Find out relevent content as
quickly as possible
Adoption
Time spent on Dev docs must
be reduced by 30% while
keeping the #New Developers
increasing
Possible Solutions
User Problem (Gap
Analysis)
Find out relevent content as
quickly as possible
Possible Solution 1 Possible Solution 2 Possible Solution 3
Build a chatbot that
understands what the user
wants and quickly provides
the same
Provide a manual Chat interface
where the users can ask their
questions
Revamp the UX providing
minimalistic experience
and intent filters
Reach Very High Low High
Impact Very High High Medium
Confidence High Medium Medium
Effort High Medium High
Priority Rank 1 3 2
Use - Assumption needs to be validated using extensive user-study (& MVP experiments)
Use Case (Chatbot)
1. User spends XX amount of time on Dev docs & still not moving ahead
2. Chatbot is displayed
Call out: Value of XX will be based on user-study
Wireframes
Solution 1 (Chatbot)
Tradeoffs for Solution
1. Opportunity cost is high
2. Developers (especially advanced ones) might not feel comfortable with this
new way to use Dev Docs
3. Developers might give incorrect input and might not understand how to use
the
4. Addition of one more feature would mean that the tech team might loose
focus on their existing tasks
Appendix
Company Vision
“to help people and businesses throughout the world
realize their full potential.”
Company Mission
“to empower every person and every organization on
the planet to achieve more.”
Teams-Competitive Landscape
Size of the target organization
#Features
Zoom
Google
Classroom
TeamViewer
Go to Webinar
Slack
Dropbox for Business
Teams
SWOT - Teams Platform
Strengths
- Credibility and brand of
Microsoft
- Good technical support
Weakness
- Difficult to transition from
Outlook
- Structure of files confuses
users
Opportunities
- Better app ecosystem
- Mass adoption i.e. B2C
Threats
- Competitors can replicate
its features
- Security i.e Hacking
User Research (for Dev Docs)
● Talked to several developers
● Questioned them about their issues with existing Dev docs
● Understood their pain points
● Used the 5 Why's method to dig deeper
User Research (observations)
● Documentation is not correct
● Error scenarios not covered
● I use 'Postman' to understand the results/errors
● Documentation is not 'sectioned' correctly
● If a doc is not clear, I do a 'Google search'
● If I get a 'sample code' it would really help
● Collaboration with other developers is critical while development
● Communication with the larger developer community i.e. experts is a delight
Target User Persona (Based on User
Research)
For Tech & Dev Docs...
Ankit's User Journey Map
1. Ease of adoption
- How to switch to the new technology/ecosystem
- Migration to the new developer platform, learn new languages
2. Consistency and standards
- Does the Dev Docs follow consistent and standard set of technologies
- Will I be able to find more developers who can code along with me on the same projec
3. Backward compatability
- Does the Dev Docs make it clear which are the APIs, tools that will be depricated and when
- Would the old applications & components be working with the deprectated Teams features or not
4. Security
- Can the apps built on top of Teams platform be hacked
- What are the other velnerabilities of the system
5. Bugs & Error Support
- How do I get my errors resolved
- Can I aviod the common errors that arise during coding
Ankit's Top Pain Points
A superior 'Tech and Dev Docs'
would help Teams build healthy app
ecosystem, developer community
and hence ensure its market
dominance.
Solution Hypothesis (Based on
User Research)
Pain Point Solution/ Feautures
1. Ease of adoption
- How to switch to the new technology/ecosystem
- Migration to the new developer platform, learn new languages
- Make it easy for developers to setup the dev tools
- Provide complete information of underlying tech-stack
2. Consistency and standards
- Does the Dev Docs follow consistent and standard set of
technologies
- Will I be able to find more developers who can code along with
me on the same project
- Connect the Developer to dev community (let him easily find
peers in his City/Region)
- Dev Docs must make it easy for developers how to code in
their existing language and integrate the same with teams
platforms
3. Backward compatability
- Does the Dev Docs make it clear which are the APIs, tools that
will be depricated and when
- Would the old applications & components be working with the
deprectated Teams features or not
- Give complete visibiltiy on timelines and life cycle of each
feature
- Provide support and incentives for the developers to migrate to
the new features and upgrade their code
4. Security
- Can the apps built on top of Teams platform be hacked
- What are the other velnerabilities of the system
- Give an overview of the architecture of teams platform to the
developers
- Clearly mention any risks or potential loop holes
5. Bugs & Error Support
- How do I get my errors resolved
- Can I aviod the common errors that arise during coding
- Provide a chatbot that can answer common developer queries
- Personalize the web pages for each developer by predicting
the type of query that they can encounter
Solution/ Feautures Reach Impact Confidence Effort
- Make it easy for developers to setup the dev tools High Medium Low Medium
- Provide complete information of underlying tech-stack High Medium Medium Medium
- Connect the Developer to dev community (let him easily find
peers in his City/Region)
High High High High
- Dev Docs must make it easy for developers how to code in
their existing language and integrate the same with teams
platforms
Very High Very High High Very High
- Give complete visibiltiy on timelines and life cycle of each
feature
Medium Medium Medium High
- Provide support and incentives for the developers to migrate
to the new features and upgrade their code
Medium Medium Medium High
- Give an overview of the architecture of teams platform to the
developers
Low Medium Low Medium
- Clearly mention any risks or potential loop holes High High Medium Low
- Provide a chatbot that can answer common developer
queries
Very High Very High Very High High
- Personalize the web pages for each developer by predicting
the type of query that they can encounter
High Very High High High
Solution/ Feautures Priority
Rank
- Provide a chatbot that can answer common developer queries 1
- Dev Docs must make it easy for developers how to code in
their existing language and integrate the same with teams
platforms
2
- Personalize the web pages for each developer by predicting
the type of query that they can encounter
3
- Connect the Developer to dev community (let him easily find
peers in his City/Region)
4
- Clearly mention any risks or potential loop holes 5
- Provide complete information of underlying tech-stack 6
- Make it easy for developers to setup the dev tools 7
- Give complete visibiltiy on timelines and life cycle of each
feature
8
- Provide support and incentives for the developers to migrate
to the new features and upgrade their code
9
- Give an overview of the architecture of teams platform to the
developers
10
Wireframes/
Information Architecture
Feature 2 (Native language
Dev Docs)
Success Metrics
Provide a chatbot that can answer common
developer queries
Dev Docs must make it easy for developers how
to code in their existing language and integrate
the same with teams platforms
Go to Market Strategy
Feature 1 (Chatbot)
Offer Provide a chatbot that can answer common
developer queries
Pricing Free to use
Market Segmentation Software developers - Teams Platform
Positioning Most advanced and easy to use tech
documentation, Cool new tech
Messaging “Checkout the coolest new chatbot that makes
it fun to code”
Strategy Capture a 'threshhold market' via paid
promotions and then make it easy for existing
users to refer the feature to other developers
Launch Plan Launch in a single city with vibrant tech
community (e.g Bangalore) and then scale to
other cities/ regions
Budget $ XXX
Go to Market Strategy
Feature 2
Offer Dev-Docs must make it easy for developers how to
code in their existing language and integrate the same
with teams platforms
Pricing Free to use
Market Segmentation Software developers - Teams Platform
Positioning Take advantage of Teams Platform and build cool
apps/components
Messaging “Work on cutting edge of technology, build cool apps
and components on top of MS Teams platform”
Strategy Promote the feature on popular tech forums e.g. Stack
overflow, Geeksforgeeks.com etc
Launch Plan Invite a few top 1% coders to try out the feature, get
their positive recommendations and then roll it out to
the wider audience
Budget $ XXX
Phase 2,3 (Future) Ideas
1. Can consider a text to voice feature that can read out the documentation
2. Online tutorials and webinars related to integration of Teams platfrom APIs etc
3. Addition of a lot of plug and play modules, libraries etc
4. Online forum where delevelopers can post their query and video chat with other
developers regarding same
5. A global community i.e. social network of Microsoft developers where they can hang out,
share their cool new projects and create online/offline events etc.
6. Online hackathons of Teams platform developers and 'open sourcing' the code
7. A completely personalized, AI based virtual assistant that helps that developers easily
discover, learn, implement and debug/troubleshoot their applications
======== End of Presentation=======

Weitere ähnliche Inhalte

Was ist angesagt?

Jeff Olson\'s Resume
Jeff Olson\'s ResumeJeff Olson\'s Resume
Jeff Olson\'s ResumeJeff Olson
 
Evolution of Software Engineering in NCTR Projects
Evolution of Software Engineering in NCTR  Projects   Evolution of Software Engineering in NCTR  Projects
Evolution of Software Engineering in NCTR Projects Mohammed Abbas
 
Pair programming demystified
Pair programming demystifiedPair programming demystified
Pair programming demystifiedMarek Kirejczyk
 
Introduction to Operating Systems
Introduction to Operating SystemsIntroduction to Operating Systems
Introduction to Operating SystemsSuhreed Sarkar
 
Teaching Kids Programming
Teaching Kids ProgrammingTeaching Kids Programming
Teaching Kids ProgrammingLynn Langit
 
Continuous delivery its not about the technology, its about the people. @pipe...
Continuous delivery its not about the technology, its about the people. @pipe...Continuous delivery its not about the technology, its about the people. @pipe...
Continuous delivery its not about the technology, its about the people. @pipe...Tomas Riha
 
Code quality as a built-in process
Code quality as a built-in processCode quality as a built-in process
Code quality as a built-in processElad Maimon
 
Selenium-corporate-training-in-mumbai
Selenium-corporate-training-in-mumbaiSelenium-corporate-training-in-mumbai
Selenium-corporate-training-in-mumbaiUnmesh Baile
 
Leveraging Open Source Automation: A Selenium WebDriver Example
Leveraging Open Source Automation: A Selenium WebDriver ExampleLeveraging Open Source Automation: A Selenium WebDriver Example
Leveraging Open Source Automation: A Selenium WebDriver ExampleTechWell
 
Devops interview questions 1 www.bigclasses.com
Devops interview questions  1  www.bigclasses.comDevops interview questions  1  www.bigclasses.com
Devops interview questions 1 www.bigclasses.combigclasses.com
 
CICD Pipeline - AWS Azure
CICD Pipeline - AWS AzureCICD Pipeline - AWS Azure
CICD Pipeline - AWS AzureRatan Das
 
DevOps made simple - Understand DevOps and steps to become a DevOps expert
DevOps made simple  - Understand DevOps and steps to become a DevOps expertDevOps made simple  - Understand DevOps and steps to become a DevOps expert
DevOps made simple - Understand DevOps and steps to become a DevOps expertThinkCerti
 
Twelve practices of XP_Se lect5 btech
Twelve practices of XP_Se lect5 btechTwelve practices of XP_Se lect5 btech
Twelve practices of XP_Se lect5 btechIIITA
 
Clean Software Design: The Practices to Make The Design Simple
Clean Software Design: The Practices to Make The Design SimpleClean Software Design: The Practices to Make The Design Simple
Clean Software Design: The Practices to Make The Design SimpleLemi Orhan Ergin
 
[Japan Selenium User Community in Remote] Test Automation Journey
[Japan Selenium User Community in Remote] Test Automation Journey[Japan Selenium User Community in Remote] Test Automation Journey
[Japan Selenium User Community in Remote] Test Automation JourneyWoohyeok Kim
 
To document or not to document? An exploratory study on developers' motivatio...
To document or not to document? An exploratory study on developers' motivatio...To document or not to document? An exploratory study on developers' motivatio...
To document or not to document? An exploratory study on developers' motivatio...Hayim Makabee
 
5 best practices in dev ops culture
5 best practices in dev ops culture5 best practices in dev ops culture
5 best practices in dev ops cultureEdureka!
 
GMO'less Software Development Practices
GMO'less Software Development PracticesGMO'less Software Development Practices
GMO'less Software Development PracticesLemi Orhan Ergin
 

Was ist angesagt? (20)

Jeff Olson\'s Resume
Jeff Olson\'s ResumeJeff Olson\'s Resume
Jeff Olson\'s Resume
 
Evolution of Software Engineering in NCTR Projects
Evolution of Software Engineering in NCTR  Projects   Evolution of Software Engineering in NCTR  Projects
Evolution of Software Engineering in NCTR Projects
 
Pair programming demystified
Pair programming demystifiedPair programming demystified
Pair programming demystified
 
Introduction to Operating Systems
Introduction to Operating SystemsIntroduction to Operating Systems
Introduction to Operating Systems
 
Teaching Kids Programming
Teaching Kids ProgrammingTeaching Kids Programming
Teaching Kids Programming
 
Continuous delivery its not about the technology, its about the people. @pipe...
Continuous delivery its not about the technology, its about the people. @pipe...Continuous delivery its not about the technology, its about the people. @pipe...
Continuous delivery its not about the technology, its about the people. @pipe...
 
Agile Testing
Agile Testing  Agile Testing
Agile Testing
 
Code quality as a built-in process
Code quality as a built-in processCode quality as a built-in process
Code quality as a built-in process
 
Selenium-corporate-training-in-mumbai
Selenium-corporate-training-in-mumbaiSelenium-corporate-training-in-mumbai
Selenium-corporate-training-in-mumbai
 
Leveraging Open Source Automation: A Selenium WebDriver Example
Leveraging Open Source Automation: A Selenium WebDriver ExampleLeveraging Open Source Automation: A Selenium WebDriver Example
Leveraging Open Source Automation: A Selenium WebDriver Example
 
Devops interview questions 1 www.bigclasses.com
Devops interview questions  1  www.bigclasses.comDevops interview questions  1  www.bigclasses.com
Devops interview questions 1 www.bigclasses.com
 
CICD Pipeline - AWS Azure
CICD Pipeline - AWS AzureCICD Pipeline - AWS Azure
CICD Pipeline - AWS Azure
 
DevOps made simple - Understand DevOps and steps to become a DevOps expert
DevOps made simple  - Understand DevOps and steps to become a DevOps expertDevOps made simple  - Understand DevOps and steps to become a DevOps expert
DevOps made simple - Understand DevOps and steps to become a DevOps expert
 
Twelve practices of XP_Se lect5 btech
Twelve practices of XP_Se lect5 btechTwelve practices of XP_Se lect5 btech
Twelve practices of XP_Se lect5 btech
 
Pair Programming
Pair ProgrammingPair Programming
Pair Programming
 
Clean Software Design: The Practices to Make The Design Simple
Clean Software Design: The Practices to Make The Design SimpleClean Software Design: The Practices to Make The Design Simple
Clean Software Design: The Practices to Make The Design Simple
 
[Japan Selenium User Community in Remote] Test Automation Journey
[Japan Selenium User Community in Remote] Test Automation Journey[Japan Selenium User Community in Remote] Test Automation Journey
[Japan Selenium User Community in Remote] Test Automation Journey
 
To document or not to document? An exploratory study on developers' motivatio...
To document or not to document? An exploratory study on developers' motivatio...To document or not to document? An exploratory study on developers' motivatio...
To document or not to document? An exploratory study on developers' motivatio...
 
5 best practices in dev ops culture
5 best practices in dev ops culture5 best practices in dev ops culture
5 best practices in dev ops culture
 
GMO'less Software Development Practices
GMO'less Software Development PracticesGMO'less Software Development Practices
GMO'less Software Development Practices
 

Ähnlich wie How to improve Developer Documentations ?

Webinar - Design Thinking for Platform Engineering
Webinar - Design Thinking for Platform EngineeringWebinar - Design Thinking for Platform Engineering
Webinar - Design Thinking for Platform EngineeringOpenCredo
 
"Platform Engineering in practice — Why and How to start", Serg Hospodarets
"Platform Engineering in practice — Why and How to start", Serg Hospodarets "Platform Engineering in practice — Why and How to start", Serg Hospodarets
"Platform Engineering in practice — Why and How to start", Serg Hospodarets Fwdays
 
Scaling a Serverless Developer Platform for Teams
Scaling a Serverless Developer Platform for TeamsScaling a Serverless Developer Platform for Teams
Scaling a Serverless Developer Platform for TeamsMikael Vesavuori
 
DevExForPlatformEngineers, introducing Kratix
DevExForPlatformEngineers, introducing KratixDevExForPlatformEngineers, introducing Kratix
DevExForPlatformEngineers, introducing KratixAbigail Bangser
 
Agile paris 2022 sharing
Agile paris 2022   sharingAgile paris 2022   sharing
Agile paris 2022 sharingJas Chong
 
Agile & DevOps - It's all about project success
Agile & DevOps - It's all about project successAgile & DevOps - It's all about project success
Agile & DevOps - It's all about project successAdam Stephensen
 
Open Source Content Management Systems for Small and Medium Businesses, Chari...
Open Source Content Management Systems for Small and Medium Businesses, Chari...Open Source Content Management Systems for Small and Medium Businesses, Chari...
Open Source Content Management Systems for Small and Medium Businesses, Chari...Will Hall
 
Open Source Project Management
Open Source Project ManagementOpen Source Project Management
Open Source Project ManagementSemen Arslan
 
Sustainability Training Workshop - Managing Sustainability into Software
Sustainability Training Workshop - Managing Sustainability into SoftwareSustainability Training Workshop - Managing Sustainability into Software
Sustainability Training Workshop - Managing Sustainability into SoftwareSoftware Sustainability Institute
 
DevOps CTO Masterclass | Webinar Oct. 2020
DevOps CTO Masterclass | Webinar Oct. 2020DevOps CTO Masterclass | Webinar Oct. 2020
DevOps CTO Masterclass | Webinar Oct. 2020Cyber-Duck
 
Sprinkle your Devops platform with product thinking.pdf
Sprinkle your Devops platform with product thinking.pdfSprinkle your Devops platform with product thinking.pdf
Sprinkle your Devops platform with product thinking.pdfJavier Turégano Molina
 
Best practices for using open source software in the enterprise
Best practices for using open source software in the enterpriseBest practices for using open source software in the enterprise
Best practices for using open source software in the enterpriseMarcel de Vries
 
Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...
Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...
Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...Joel Oleson
 
30 days or less: New Features to Production
30 days or less: New Features to Production30 days or less: New Features to Production
30 days or less: New Features to ProductionKarthik Gaekwad
 
Office 365 Developer Bootcamp: Microsoft Teams
Office 365 Developer Bootcamp: Microsoft TeamsOffice 365 Developer Bootcamp: Microsoft Teams
Office 365 Developer Bootcamp: Microsoft TeamsDavid Schneider
 
Large scale agile development practices
Large scale agile development practicesLarge scale agile development practices
Large scale agile development practicesSkills Matter
 
Slides from "Taking an Holistic Approach to Product Quality"
Slides from "Taking an Holistic Approach to Product Quality"Slides from "Taking an Holistic Approach to Product Quality"
Slides from "Taking an Holistic Approach to Product Quality"Peter Marshall
 

Ähnlich wie How to improve Developer Documentations ? (20)

Webinar - Design Thinking for Platform Engineering
Webinar - Design Thinking for Platform EngineeringWebinar - Design Thinking for Platform Engineering
Webinar - Design Thinking for Platform Engineering
 
"Platform Engineering in practice — Why and How to start", Serg Hospodarets
"Platform Engineering in practice — Why and How to start", Serg Hospodarets "Platform Engineering in practice — Why and How to start", Serg Hospodarets
"Platform Engineering in practice — Why and How to start", Serg Hospodarets
 
Computer software specialists wikki verma
Computer software specialists   wikki vermaComputer software specialists   wikki verma
Computer software specialists wikki verma
 
Scaling a Serverless Developer Platform for Teams
Scaling a Serverless Developer Platform for TeamsScaling a Serverless Developer Platform for Teams
Scaling a Serverless Developer Platform for Teams
 
DevExForPlatformEngineers, introducing Kratix
DevExForPlatformEngineers, introducing KratixDevExForPlatformEngineers, introducing Kratix
DevExForPlatformEngineers, introducing Kratix
 
Agile paris 2022 sharing
Agile paris 2022   sharingAgile paris 2022   sharing
Agile paris 2022 sharing
 
Agile & DevOps - It's all about project success
Agile & DevOps - It's all about project successAgile & DevOps - It's all about project success
Agile & DevOps - It's all about project success
 
Open Source Content Management Systems for Small and Medium Businesses, Chari...
Open Source Content Management Systems for Small and Medium Businesses, Chari...Open Source Content Management Systems for Small and Medium Businesses, Chari...
Open Source Content Management Systems for Small and Medium Businesses, Chari...
 
Open Source Project Management
Open Source Project ManagementOpen Source Project Management
Open Source Project Management
 
Sustainability Training Workshop - Managing Sustainability into Software
Sustainability Training Workshop - Managing Sustainability into SoftwareSustainability Training Workshop - Managing Sustainability into Software
Sustainability Training Workshop - Managing Sustainability into Software
 
DevOps CTO Masterclass | Webinar Oct. 2020
DevOps CTO Masterclass | Webinar Oct. 2020DevOps CTO Masterclass | Webinar Oct. 2020
DevOps CTO Masterclass | Webinar Oct. 2020
 
Sprinkle your Devops platform with product thinking.pdf
Sprinkle your Devops platform with product thinking.pdfSprinkle your Devops platform with product thinking.pdf
Sprinkle your Devops platform with product thinking.pdf
 
Capstone- Milestone 3
Capstone- Milestone 3Capstone- Milestone 3
Capstone- Milestone 3
 
Best practices for using open source software in the enterprise
Best practices for using open source software in the enterpriseBest practices for using open source software in the enterprise
Best practices for using open source software in the enterprise
 
Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...
Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...
Microsoft Teams as a Platform - Microsoft 365 Application Platform Maturity M...
 
30 days or less: New Features to Production
30 days or less: New Features to Production30 days or less: New Features to Production
30 days or less: New Features to Production
 
Office 365 Developer Bootcamp: Microsoft Teams
Office 365 Developer Bootcamp: Microsoft TeamsOffice 365 Developer Bootcamp: Microsoft Teams
Office 365 Developer Bootcamp: Microsoft Teams
 
Large scale agile development practices
Large scale agile development practicesLarge scale agile development practices
Large scale agile development practices
 
Slides from "Taking an Holistic Approach to Product Quality"
Slides from "Taking an Holistic Approach to Product Quality"Slides from "Taking an Holistic Approach to Product Quality"
Slides from "Taking an Holistic Approach to Product Quality"
 
The Modern Software Architect
The Modern Software ArchitectThe Modern Software Architect
The Modern Software Architect
 

Kürzlich hochgeladen

A Journey Into the Emotions of Software Developers
A Journey Into the Emotions of Software DevelopersA Journey Into the Emotions of Software Developers
A Journey Into the Emotions of Software DevelopersNicole Novielli
 
Potential of AI (Generative AI) in Business: Learnings and Insights
Potential of AI (Generative AI) in Business: Learnings and InsightsPotential of AI (Generative AI) in Business: Learnings and Insights
Potential of AI (Generative AI) in Business: Learnings and InsightsRavi Sanghani
 
Landscape Catalogue 2024 Australia-1.pdf
Landscape Catalogue 2024 Australia-1.pdfLandscape Catalogue 2024 Australia-1.pdf
Landscape Catalogue 2024 Australia-1.pdfAarwolf Industries LLC
 
A Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptxA Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptxLoriGlavin3
 
Emixa Mendix Meetup 11 April 2024 about Mendix Native development
Emixa Mendix Meetup 11 April 2024 about Mendix Native developmentEmixa Mendix Meetup 11 April 2024 about Mendix Native development
Emixa Mendix Meetup 11 April 2024 about Mendix Native developmentPim van der Noll
 
Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...
Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...
Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...Jeffrey Haguewood
 
Connecting the Dots for Information Discovery.pdf
Connecting the Dots for Information Discovery.pdfConnecting the Dots for Information Discovery.pdf
Connecting the Dots for Information Discovery.pdfNeo4j
 
Glenn Lazarus- Why Your Observability Strategy Needs Security Observability
Glenn Lazarus- Why Your Observability Strategy Needs Security ObservabilityGlenn Lazarus- Why Your Observability Strategy Needs Security Observability
Glenn Lazarus- Why Your Observability Strategy Needs Security Observabilityitnewsafrica
 
QCon London: Mastering long-running processes in modern architectures
QCon London: Mastering long-running processes in modern architecturesQCon London: Mastering long-running processes in modern architectures
QCon London: Mastering long-running processes in modern architecturesBernd Ruecker
 
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptxPasskey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptxLoriGlavin3
 
Modern Roaming for Notes and Nomad – Cheaper Faster Better Stronger
Modern Roaming for Notes and Nomad – Cheaper Faster Better StrongerModern Roaming for Notes and Nomad – Cheaper Faster Better Stronger
Modern Roaming for Notes and Nomad – Cheaper Faster Better Strongerpanagenda
 
Testing tools and AI - ideas what to try with some tool examples
Testing tools and AI - ideas what to try with some tool examplesTesting tools and AI - ideas what to try with some tool examples
Testing tools and AI - ideas what to try with some tool examplesKari Kakkonen
 
Top 10 Hubspot Development Companies in 2024
Top 10 Hubspot Development Companies in 2024Top 10 Hubspot Development Companies in 2024
Top 10 Hubspot Development Companies in 2024TopCSSGallery
 
The Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptx
The Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptxThe Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptx
The Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptxLoriGlavin3
 
The State of Passkeys with FIDO Alliance.pptx
The State of Passkeys with FIDO Alliance.pptxThe State of Passkeys with FIDO Alliance.pptx
The State of Passkeys with FIDO Alliance.pptxLoriGlavin3
 
A Glance At The Java Performance Toolbox
A Glance At The Java Performance ToolboxA Glance At The Java Performance Toolbox
A Glance At The Java Performance ToolboxAna-Maria Mihalceanu
 
Long journey of Ruby standard library at RubyConf AU 2024
Long journey of Ruby standard library at RubyConf AU 2024Long journey of Ruby standard library at RubyConf AU 2024
Long journey of Ruby standard library at RubyConf AU 2024Hiroshi SHIBATA
 
Digital Identity is Under Attack: FIDO Paris Seminar.pptx
Digital Identity is Under Attack: FIDO Paris Seminar.pptxDigital Identity is Under Attack: FIDO Paris Seminar.pptx
Digital Identity is Under Attack: FIDO Paris Seminar.pptxLoriGlavin3
 
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyesHow to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyesThousandEyes
 
Generative Artificial Intelligence: How generative AI works.pdf
Generative Artificial Intelligence: How generative AI works.pdfGenerative Artificial Intelligence: How generative AI works.pdf
Generative Artificial Intelligence: How generative AI works.pdfIngrid Airi González
 

Kürzlich hochgeladen (20)

A Journey Into the Emotions of Software Developers
A Journey Into the Emotions of Software DevelopersA Journey Into the Emotions of Software Developers
A Journey Into the Emotions of Software Developers
 
Potential of AI (Generative AI) in Business: Learnings and Insights
Potential of AI (Generative AI) in Business: Learnings and InsightsPotential of AI (Generative AI) in Business: Learnings and Insights
Potential of AI (Generative AI) in Business: Learnings and Insights
 
Landscape Catalogue 2024 Australia-1.pdf
Landscape Catalogue 2024 Australia-1.pdfLandscape Catalogue 2024 Australia-1.pdf
Landscape Catalogue 2024 Australia-1.pdf
 
A Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptxA Deep Dive on Passkeys: FIDO Paris Seminar.pptx
A Deep Dive on Passkeys: FIDO Paris Seminar.pptx
 
Emixa Mendix Meetup 11 April 2024 about Mendix Native development
Emixa Mendix Meetup 11 April 2024 about Mendix Native developmentEmixa Mendix Meetup 11 April 2024 about Mendix Native development
Emixa Mendix Meetup 11 April 2024 about Mendix Native development
 
Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...
Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...
Email Marketing Automation for Bonterra Impact Management (fka Social Solutio...
 
Connecting the Dots for Information Discovery.pdf
Connecting the Dots for Information Discovery.pdfConnecting the Dots for Information Discovery.pdf
Connecting the Dots for Information Discovery.pdf
 
Glenn Lazarus- Why Your Observability Strategy Needs Security Observability
Glenn Lazarus- Why Your Observability Strategy Needs Security ObservabilityGlenn Lazarus- Why Your Observability Strategy Needs Security Observability
Glenn Lazarus- Why Your Observability Strategy Needs Security Observability
 
QCon London: Mastering long-running processes in modern architectures
QCon London: Mastering long-running processes in modern architecturesQCon London: Mastering long-running processes in modern architectures
QCon London: Mastering long-running processes in modern architectures
 
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptxPasskey Providers and Enabling Portability: FIDO Paris Seminar.pptx
Passkey Providers and Enabling Portability: FIDO Paris Seminar.pptx
 
Modern Roaming for Notes and Nomad – Cheaper Faster Better Stronger
Modern Roaming for Notes and Nomad – Cheaper Faster Better StrongerModern Roaming for Notes and Nomad – Cheaper Faster Better Stronger
Modern Roaming for Notes and Nomad – Cheaper Faster Better Stronger
 
Testing tools and AI - ideas what to try with some tool examples
Testing tools and AI - ideas what to try with some tool examplesTesting tools and AI - ideas what to try with some tool examples
Testing tools and AI - ideas what to try with some tool examples
 
Top 10 Hubspot Development Companies in 2024
Top 10 Hubspot Development Companies in 2024Top 10 Hubspot Development Companies in 2024
Top 10 Hubspot Development Companies in 2024
 
The Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptx
The Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptxThe Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptx
The Role of FIDO in a Cyber Secure Netherlands: FIDO Paris Seminar.pptx
 
The State of Passkeys with FIDO Alliance.pptx
The State of Passkeys with FIDO Alliance.pptxThe State of Passkeys with FIDO Alliance.pptx
The State of Passkeys with FIDO Alliance.pptx
 
A Glance At The Java Performance Toolbox
A Glance At The Java Performance ToolboxA Glance At The Java Performance Toolbox
A Glance At The Java Performance Toolbox
 
Long journey of Ruby standard library at RubyConf AU 2024
Long journey of Ruby standard library at RubyConf AU 2024Long journey of Ruby standard library at RubyConf AU 2024
Long journey of Ruby standard library at RubyConf AU 2024
 
Digital Identity is Under Attack: FIDO Paris Seminar.pptx
Digital Identity is Under Attack: FIDO Paris Seminar.pptxDigital Identity is Under Attack: FIDO Paris Seminar.pptx
Digital Identity is Under Attack: FIDO Paris Seminar.pptx
 
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyesHow to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
How to Effectively Monitor SD-WAN and SASE Environments with ThousandEyes
 
Generative Artificial Intelligence: How generative AI works.pdf
Generative Artificial Intelligence: How generative AI works.pdfGenerative Artificial Intelligence: How generative AI works.pdf
Generative Artificial Intelligence: How generative AI works.pdf
 

How to improve Developer Documentations ?

  • 3. Company Mission (for developers) “to empower every developer and every dev based organization on the planet to achieve more.” Teams Platform Vision “to provide a single hub for teamwork in Office 365 since teamwork is essential to the way work gets done today.”
  • 4. Objective of Teams Dev Docs “to get the developers off the Dev docs as soon as possible so that they can start building apps.”
  • 6. Launched No. of Third Party Apps No. of Developers Slack 2013 1,800 600,000 Microsoft Teams 2017 500+ Initial Stages Zoom 2011 700+ N/A
  • 7. Slack API Docs (First Fold)
  • 8. Teams API Docs (First Fold)
  • 9. Development Stages & Pain Points
  • 10. Stage of Development Awareness Discovery Learning Implementation Debugging Developer Pain Points Not sure about which platform to choose and why What are the documents that would help me resolve my questions How to get overview of the platform capabilities/ integrations How to quickly integrate sample code Find out common errors and their solutions Role of Teams Dev Docs (Dev Level: Beginner) N/A Be easily discoverable on Search engines, prompt the user to learn more Discover what are the areas that the Developer is weak in, provide tutorials Step by step guide to impelmentation, providing support whereever necessary List out the most common errors and provide support in case the Dev is unable to proceed Role of Teams Dev Docs (Dev Level: Intermediate) Introduction to the Teams platform capabilities Be easily discoverable on Search engines, prompt the user to try code N/A Provide a way to test out the APIs and its request/response data Provide support and a way to connect with experts Role of Teams Dev Docs (Dev Level: Advanced) Why the developers must choose to build on Teams platform over other platforms N/A N/A Provide sample code and other resourses as quickly as possible Incentivize them to contribute to the Developer forums
  • 12. Business Objective User Problem (Gap Analysis) Product Stage Metric to be moved Create a large developer community for Teams platform Find out relevent content as quickly as possible Adoption Time spent on Dev docs must be reduced by 30% while keeping the #New Developers increasing Call out - Assumption needs to be validated using extensive user-study (& MVP experiments) Business Objective User Problem (Gap Analysis) Product Stage Metric to be moved Create a large developer community for Teams platform Find out relevent content as quickly as possible Adoption Time spent on Dev docs must be reduced by 30% while keeping the #New Developers increasing
  • 14. User Problem (Gap Analysis) Find out relevent content as quickly as possible Possible Solution 1 Possible Solution 2 Possible Solution 3 Build a chatbot that understands what the user wants and quickly provides the same Provide a manual Chat interface where the users can ask their questions Revamp the UX providing minimalistic experience and intent filters Reach Very High Low High Impact Very High High Medium Confidence High Medium Medium Effort High Medium High Priority Rank 1 3 2 Use - Assumption needs to be validated using extensive user-study (& MVP experiments)
  • 15. Use Case (Chatbot) 1. User spends XX amount of time on Dev docs & still not moving ahead 2. Chatbot is displayed Call out: Value of XX will be based on user-study
  • 17.
  • 18.
  • 19. Tradeoffs for Solution 1. Opportunity cost is high 2. Developers (especially advanced ones) might not feel comfortable with this new way to use Dev Docs 3. Developers might give incorrect input and might not understand how to use the 4. Addition of one more feature would mean that the tech team might loose focus on their existing tasks
  • 21. Company Vision “to help people and businesses throughout the world realize their full potential.” Company Mission “to empower every person and every organization on the planet to achieve more.”
  • 22. Teams-Competitive Landscape Size of the target organization #Features Zoom Google Classroom TeamViewer Go to Webinar Slack Dropbox for Business Teams
  • 23. SWOT - Teams Platform Strengths - Credibility and brand of Microsoft - Good technical support Weakness - Difficult to transition from Outlook - Structure of files confuses users Opportunities - Better app ecosystem - Mass adoption i.e. B2C Threats - Competitors can replicate its features - Security i.e Hacking
  • 24. User Research (for Dev Docs) ● Talked to several developers ● Questioned them about their issues with existing Dev docs ● Understood their pain points ● Used the 5 Why's method to dig deeper
  • 25. User Research (observations) ● Documentation is not correct ● Error scenarios not covered ● I use 'Postman' to understand the results/errors ● Documentation is not 'sectioned' correctly ● If a doc is not clear, I do a 'Google search' ● If I get a 'sample code' it would really help ● Collaboration with other developers is critical while development ● Communication with the larger developer community i.e. experts is a delight
  • 26. Target User Persona (Based on User Research) For Tech & Dev Docs...
  • 27.
  • 29. 1. Ease of adoption - How to switch to the new technology/ecosystem - Migration to the new developer platform, learn new languages 2. Consistency and standards - Does the Dev Docs follow consistent and standard set of technologies - Will I be able to find more developers who can code along with me on the same projec 3. Backward compatability - Does the Dev Docs make it clear which are the APIs, tools that will be depricated and when - Would the old applications & components be working with the deprectated Teams features or not 4. Security - Can the apps built on top of Teams platform be hacked - What are the other velnerabilities of the system 5. Bugs & Error Support - How do I get my errors resolved - Can I aviod the common errors that arise during coding Ankit's Top Pain Points
  • 30. A superior 'Tech and Dev Docs' would help Teams build healthy app ecosystem, developer community and hence ensure its market dominance. Solution Hypothesis (Based on User Research)
  • 31. Pain Point Solution/ Feautures 1. Ease of adoption - How to switch to the new technology/ecosystem - Migration to the new developer platform, learn new languages - Make it easy for developers to setup the dev tools - Provide complete information of underlying tech-stack 2. Consistency and standards - Does the Dev Docs follow consistent and standard set of technologies - Will I be able to find more developers who can code along with me on the same project - Connect the Developer to dev community (let him easily find peers in his City/Region) - Dev Docs must make it easy for developers how to code in their existing language and integrate the same with teams platforms 3. Backward compatability - Does the Dev Docs make it clear which are the APIs, tools that will be depricated and when - Would the old applications & components be working with the deprectated Teams features or not - Give complete visibiltiy on timelines and life cycle of each feature - Provide support and incentives for the developers to migrate to the new features and upgrade their code 4. Security - Can the apps built on top of Teams platform be hacked - What are the other velnerabilities of the system - Give an overview of the architecture of teams platform to the developers - Clearly mention any risks or potential loop holes 5. Bugs & Error Support - How do I get my errors resolved - Can I aviod the common errors that arise during coding - Provide a chatbot that can answer common developer queries - Personalize the web pages for each developer by predicting the type of query that they can encounter
  • 32. Solution/ Feautures Reach Impact Confidence Effort - Make it easy for developers to setup the dev tools High Medium Low Medium - Provide complete information of underlying tech-stack High Medium Medium Medium - Connect the Developer to dev community (let him easily find peers in his City/Region) High High High High - Dev Docs must make it easy for developers how to code in their existing language and integrate the same with teams platforms Very High Very High High Very High - Give complete visibiltiy on timelines and life cycle of each feature Medium Medium Medium High - Provide support and incentives for the developers to migrate to the new features and upgrade their code Medium Medium Medium High - Give an overview of the architecture of teams platform to the developers Low Medium Low Medium - Clearly mention any risks or potential loop holes High High Medium Low - Provide a chatbot that can answer common developer queries Very High Very High Very High High - Personalize the web pages for each developer by predicting the type of query that they can encounter High Very High High High
  • 33. Solution/ Feautures Priority Rank - Provide a chatbot that can answer common developer queries 1 - Dev Docs must make it easy for developers how to code in their existing language and integrate the same with teams platforms 2 - Personalize the web pages for each developer by predicting the type of query that they can encounter 3 - Connect the Developer to dev community (let him easily find peers in his City/Region) 4 - Clearly mention any risks or potential loop holes 5 - Provide complete information of underlying tech-stack 6 - Make it easy for developers to setup the dev tools 7 - Give complete visibiltiy on timelines and life cycle of each feature 8 - Provide support and incentives for the developers to migrate to the new features and upgrade their code 9 - Give an overview of the architecture of teams platform to the developers 10
  • 35.
  • 37. Provide a chatbot that can answer common developer queries
  • 38. Dev Docs must make it easy for developers how to code in their existing language and integrate the same with teams platforms
  • 39. Go to Market Strategy Feature 1 (Chatbot)
  • 40. Offer Provide a chatbot that can answer common developer queries Pricing Free to use Market Segmentation Software developers - Teams Platform Positioning Most advanced and easy to use tech documentation, Cool new tech Messaging “Checkout the coolest new chatbot that makes it fun to code” Strategy Capture a 'threshhold market' via paid promotions and then make it easy for existing users to refer the feature to other developers Launch Plan Launch in a single city with vibrant tech community (e.g Bangalore) and then scale to other cities/ regions Budget $ XXX
  • 41. Go to Market Strategy Feature 2
  • 42. Offer Dev-Docs must make it easy for developers how to code in their existing language and integrate the same with teams platforms Pricing Free to use Market Segmentation Software developers - Teams Platform Positioning Take advantage of Teams Platform and build cool apps/components Messaging “Work on cutting edge of technology, build cool apps and components on top of MS Teams platform” Strategy Promote the feature on popular tech forums e.g. Stack overflow, Geeksforgeeks.com etc Launch Plan Invite a few top 1% coders to try out the feature, get their positive recommendations and then roll it out to the wider audience Budget $ XXX
  • 43. Phase 2,3 (Future) Ideas 1. Can consider a text to voice feature that can read out the documentation 2. Online tutorials and webinars related to integration of Teams platfrom APIs etc 3. Addition of a lot of plug and play modules, libraries etc 4. Online forum where delevelopers can post their query and video chat with other developers regarding same 5. A global community i.e. social network of Microsoft developers where they can hang out, share their cool new projects and create online/offline events etc. 6. Online hackathons of Teams platform developers and 'open sourcing' the code 7. A completely personalized, AI based virtual assistant that helps that developers easily discover, learn, implement and debug/troubleshoot their applications
  • 44. ======== End of Presentation=======