SlideShare a Scribd company logo
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=======

More Related Content

What's hot

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 demystified
Marek Kirejczyk
 
Introduction to Operating Systems
Introduction to Operating SystemsIntroduction to Operating Systems
Introduction to Operating Systems
Suhreed 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
 
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
Elad Maimon
 
Selenium-corporate-training-in-mumbai
Selenium-corporate-training-in-mumbaiSelenium-corporate-training-in-mumbai
Selenium-corporate-training-in-mumbai
Unmesh 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 Example
TechWell
 
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
bigclasses.com
 
CICD Pipeline - AWS Azure
CICD Pipeline - AWS AzureCICD Pipeline - AWS Azure
CICD Pipeline - AWS Azure
Ratan 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 expert
ThinkCerti
 
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 Simple
Lemi 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 Journey
Woohyeok 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 culture
Edureka!
 
GMO'less Software Development Practices
GMO'less Software Development PracticesGMO'less Software Development Practices
GMO'less Software Development Practices
Lemi Orhan Ergin
 

What's hot (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
 

Similar to 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 Engineering
OpenCredo
 
"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
 
Computer software specialists wikki verma
Computer software specialists   wikki vermaComputer software specialists   wikki verma
Computer software specialists wikki verma
Livingston Technology Solution
 
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
Mikael Vesavuori
 
DevExForPlatformEngineers, introducing Kratix
DevExForPlatformEngineers, introducing KratixDevExForPlatformEngineers, introducing Kratix
DevExForPlatformEngineers, introducing Kratix
Abigail Bangser
 
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
Adam 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 Management
Semen 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 Software
Software Sustainability Institute
 
DevOps CTO Masterclass | Webinar Oct. 2020
DevOps CTO Masterclass | Webinar Oct. 2020DevOps CTO Masterclass | Webinar Oct. 2020
DevOps CTO Masterclass | Webinar Oct. 2020
Cyber-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.pdf
Javier Turégano Molina
 
Capstone- Milestone 3
Capstone- Milestone 3Capstone- Milestone 3
Capstone- Milestone 3
BrittanyDavis100580
 
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
Marcel 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 Production
Karthik Gaekwad
 
Office 365 Developer Bootcamp: Microsoft Teams
Office 365 Developer Bootcamp: Microsoft TeamsOffice 365 Developer Bootcamp: Microsoft Teams
Office 365 Developer Bootcamp: Microsoft Teams
David 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
 
The Modern Software Architect
The Modern Software ArchitectThe Modern Software Architect
The Modern Software Architect
Niels Bech Nielsen
 
ICONIQ Analytics: The Modern Developer Technology Stack
ICONIQ Analytics: The Modern Developer Technology StackICONIQ Analytics: The Modern Developer Technology Stack
ICONIQ Analytics: The Modern Developer Technology Stack
Christine Edmonds
 

Similar to 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 & 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
 
ICONIQ Analytics: The Modern Developer Technology Stack
ICONIQ Analytics: The Modern Developer Technology StackICONIQ Analytics: The Modern Developer Technology Stack
ICONIQ Analytics: The Modern Developer Technology Stack
 

Recently uploaded

Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf
Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdfObservability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf
Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf
Paige Cruz
 
Introduction to CHERI technology - Cybersecurity
Introduction to CHERI technology - CybersecurityIntroduction to CHERI technology - Cybersecurity
Introduction to CHERI technology - Cybersecurity
mikeeftimakis1
 
Unlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdf
Unlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdfUnlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdf
Unlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdf
Malak Abu Hammad
 
GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...
GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...
GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...
Neo4j
 
Full-RAG: A modern architecture for hyper-personalization
Full-RAG: A modern architecture for hyper-personalizationFull-RAG: A modern architecture for hyper-personalization
Full-RAG: A modern architecture for hyper-personalization
Zilliz
 
UiPath Test Automation using UiPath Test Suite series, part 6
UiPath Test Automation using UiPath Test Suite series, part 6UiPath Test Automation using UiPath Test Suite series, part 6
UiPath Test Automation using UiPath Test Suite series, part 6
DianaGray10
 
Pushing the limits of ePRTC: 100ns holdover for 100 days
Pushing the limits of ePRTC: 100ns holdover for 100 daysPushing the limits of ePRTC: 100ns holdover for 100 days
Pushing the limits of ePRTC: 100ns holdover for 100 days
Adtran
 
DevOps and Testing slides at DASA Connect
DevOps and Testing slides at DASA ConnectDevOps and Testing slides at DASA Connect
DevOps and Testing slides at DASA Connect
Kari Kakkonen
 
Encryption in Microsoft 365 - ExpertsLive Netherlands 2024
Encryption in Microsoft 365 - ExpertsLive Netherlands 2024Encryption in Microsoft 365 - ExpertsLive Netherlands 2024
Encryption in Microsoft 365 - ExpertsLive Netherlands 2024
Albert Hoitingh
 
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AIEnchancing adoption of Open Source Libraries. A case study on Albumentations.AI
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI
Vladimir Iglovikov, Ph.D.
 
GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024
GraphSummit Singapore | The Art of the  Possible with Graph - Q2 2024GraphSummit Singapore | The Art of the  Possible with Graph - Q2 2024
GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024
Neo4j
 
Essentials of Automations: The Art of Triggers and Actions in FME
Essentials of Automations: The Art of Triggers and Actions in FMEEssentials of Automations: The Art of Triggers and Actions in FME
Essentials of Automations: The Art of Triggers and Actions in FME
Safe Software
 
zkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex Proofs
zkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex ProofszkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex Proofs
zkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex Proofs
Alex Pruden
 
Removing Uninteresting Bytes in Software Fuzzing
Removing Uninteresting Bytes in Software FuzzingRemoving Uninteresting Bytes in Software Fuzzing
Removing Uninteresting Bytes in Software Fuzzing
Aftab Hussain
 
Large Language Model (LLM) and it’s Geospatial Applications
Large Language Model (LLM) and it’s Geospatial ApplicationsLarge Language Model (LLM) and it’s Geospatial Applications
Large Language Model (LLM) and it’s Geospatial Applications
Rohit Gautam
 
20 Comprehensive Checklist of Designing and Developing a Website
20 Comprehensive Checklist of Designing and Developing a Website20 Comprehensive Checklist of Designing and Developing a Website
20 Comprehensive Checklist of Designing and Developing a Website
Pixlogix Infotech
 
GridMate - End to end testing is a critical piece to ensure quality and avoid...
GridMate - End to end testing is a critical piece to ensure quality and avoid...GridMate - End to end testing is a critical piece to ensure quality and avoid...
GridMate - End to end testing is a critical piece to ensure quality and avoid...
ThomasParaiso2
 
Generative AI Deep Dive: Advancing from Proof of Concept to Production
Generative AI Deep Dive: Advancing from Proof of Concept to ProductionGenerative AI Deep Dive: Advancing from Proof of Concept to Production
Generative AI Deep Dive: Advancing from Proof of Concept to Production
Aggregage
 
Epistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI supportEpistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI support
Alan Dix
 
Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !
KatiaHIMEUR1
 

Recently uploaded (20)

Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf
Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdfObservability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf
Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdf
 
Introduction to CHERI technology - Cybersecurity
Introduction to CHERI technology - CybersecurityIntroduction to CHERI technology - Cybersecurity
Introduction to CHERI technology - Cybersecurity
 
Unlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdf
Unlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdfUnlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdf
Unlock the Future of Search with MongoDB Atlas_ Vector Search Unleashed.pdf
 
GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...
GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...
GraphSummit Singapore | Graphing Success: Revolutionising Organisational Stru...
 
Full-RAG: A modern architecture for hyper-personalization
Full-RAG: A modern architecture for hyper-personalizationFull-RAG: A modern architecture for hyper-personalization
Full-RAG: A modern architecture for hyper-personalization
 
UiPath Test Automation using UiPath Test Suite series, part 6
UiPath Test Automation using UiPath Test Suite series, part 6UiPath Test Automation using UiPath Test Suite series, part 6
UiPath Test Automation using UiPath Test Suite series, part 6
 
Pushing the limits of ePRTC: 100ns holdover for 100 days
Pushing the limits of ePRTC: 100ns holdover for 100 daysPushing the limits of ePRTC: 100ns holdover for 100 days
Pushing the limits of ePRTC: 100ns holdover for 100 days
 
DevOps and Testing slides at DASA Connect
DevOps and Testing slides at DASA ConnectDevOps and Testing slides at DASA Connect
DevOps and Testing slides at DASA Connect
 
Encryption in Microsoft 365 - ExpertsLive Netherlands 2024
Encryption in Microsoft 365 - ExpertsLive Netherlands 2024Encryption in Microsoft 365 - ExpertsLive Netherlands 2024
Encryption in Microsoft 365 - ExpertsLive Netherlands 2024
 
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AIEnchancing adoption of Open Source Libraries. A case study on Albumentations.AI
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI
 
GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024
GraphSummit Singapore | The Art of the  Possible with Graph - Q2 2024GraphSummit Singapore | The Art of the  Possible with Graph - Q2 2024
GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024
 
Essentials of Automations: The Art of Triggers and Actions in FME
Essentials of Automations: The Art of Triggers and Actions in FMEEssentials of Automations: The Art of Triggers and Actions in FME
Essentials of Automations: The Art of Triggers and Actions in FME
 
zkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex Proofs
zkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex ProofszkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex Proofs
zkStudyClub - Reef: Fast Succinct Non-Interactive Zero-Knowledge Regex Proofs
 
Removing Uninteresting Bytes in Software Fuzzing
Removing Uninteresting Bytes in Software FuzzingRemoving Uninteresting Bytes in Software Fuzzing
Removing Uninteresting Bytes in Software Fuzzing
 
Large Language Model (LLM) and it’s Geospatial Applications
Large Language Model (LLM) and it’s Geospatial ApplicationsLarge Language Model (LLM) and it’s Geospatial Applications
Large Language Model (LLM) and it’s Geospatial Applications
 
20 Comprehensive Checklist of Designing and Developing a Website
20 Comprehensive Checklist of Designing and Developing a Website20 Comprehensive Checklist of Designing and Developing a Website
20 Comprehensive Checklist of Designing and Developing a Website
 
GridMate - End to end testing is a critical piece to ensure quality and avoid...
GridMate - End to end testing is a critical piece to ensure quality and avoid...GridMate - End to end testing is a critical piece to ensure quality and avoid...
GridMate - End to end testing is a critical piece to ensure quality and avoid...
 
Generative AI Deep Dive: Advancing from Proof of Concept to Production
Generative AI Deep Dive: Advancing from Proof of Concept to ProductionGenerative AI Deep Dive: Advancing from Proof of Concept to Production
Generative AI Deep Dive: Advancing from Proof of Concept to Production
 
Epistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI supportEpistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI support
 
Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !
 

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=======