SlideShare a Scribd company logo
1 of 24
Download to read offline
Entry points & guide posts:
Helping contributors find
their way
Janet Swisher
Community Manager, Mozilla Developer Network
@jmswisher
2
What the heck am I talking about?
open documentation
Docs, internal or external, that people outside your team can modify
contributor
Anyone who modifies your docs who doesn't have "Technical writer for
{your_team_name}" in their job description
Background: http://www.slideshare.net/janetswisher
3
How to drive people away
5
Ways to encourage contribution
Strategy Tactic
Streamline the path from
interest to success
More-focused Getting Started page
Create invitations, not
roadblocks
Show non-English readers what's
not translated
Expose what areas need help, in
what ways
Doc status pages for topics and
locales
6
Streamline the
path from
interest to
success
Create
invitations, not
roadblocks
Expose what
areas need help,
in what ways
Results over time
Data are noisy; direct cause and effect is hard to prove. But we seem to
be doing something right. 21
Do it yourself
•  Streamline the path from interest to success
•  Create invitations, not roadblocks
•  Expose opportunities
•  What needs to be done
•  How to do it
Improve the CX (Contributor Experience)
22
Plain old UX work is good too
23
Continue the conversation on Twitter: @jmswisher
Thanks! Discuss!

More Related Content

Similar to Entry points and guide posts: Helping contributors find their way

Engineering content-champions-todd-stc-2017
Engineering content-champions-todd-stc-2017Engineering content-champions-todd-stc-2017
Engineering content-champions-todd-stc-2017Becky Todd
 
Drive Member Engagement through Revitalized Chapter Events
Drive Member Engagement through Revitalized Chapter EventsDrive Member Engagement through Revitalized Chapter Events
Drive Member Engagement through Revitalized Chapter EventsBillhighway
 
August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...
August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...
August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...VolunteerMatch
 
Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...
Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...
Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...Greg Bonnette
 
Get it right the first time - AJ Davis - Product Camp Austin 2018
Get it right the first time - AJ Davis - Product Camp Austin 2018Get it right the first time - AJ Davis - Product Camp Austin 2018
Get it right the first time - AJ Davis - Product Camp Austin 2018AJ Davis
 
Disruptive Innovation: How fresh thinking can propel your small business forw...
Disruptive Innovation: How fresh thinking can propel your small business forw...Disruptive Innovation: How fresh thinking can propel your small business forw...
Disruptive Innovation: How fresh thinking can propel your small business forw...Manta
 
Harnessing Your Experts’ Knowledge for Sustainable Competitive Advantage
Harnessing Your Experts’ Knowledge for Sustainable Competitive AdvantageHarnessing Your Experts’ Knowledge for Sustainable Competitive Advantage
Harnessing Your Experts’ Knowledge for Sustainable Competitive AdvantageEmerson Exchange
 
More Than a Feeling: Data-Informed Design
More Than a Feeling: Data-Informed DesignMore Than a Feeling: Data-Informed Design
More Than a Feeling: Data-Informed DesignCourtney Clark
 
Elicitation Techniques
Elicitation TechniquesElicitation Techniques
Elicitation TechniquesSwati Sinha
 
Social Learning Tactics for Learning Designers
Social Learning Tactics for Learning DesignersSocial Learning Tactics for Learning Designers
Social Learning Tactics for Learning DesignersMike Taylor
 
Chapter Engagement: 5 Trends for 2017
Chapter Engagement: 5 Trends for 2017Chapter Engagement: 5 Trends for 2017
Chapter Engagement: 5 Trends for 2017Billhighway
 
How to create effective and optimized content by jen silverman
How to create effective and optimized content by jen silvermanHow to create effective and optimized content by jen silverman
How to create effective and optimized content by jen silvermanGlen Dimaandal
 
Getting Started with Higher Ed Web Governance kickstarter guide
Getting Started with Higher Ed Web Governance kickstarter guideGetting Started with Higher Ed Web Governance kickstarter guide
Getting Started with Higher Ed Web Governance kickstarter guideAligned Path
 
Collaboration from the Trenches : Building your Internal Communities with Mic...
Collaboration from the Trenches : Building your Internal Communities with Mic...Collaboration from the Trenches : Building your Internal Communities with Mic...
Collaboration from the Trenches : Building your Internal Communities with Mic...D'arce Hess
 
Gathering Feedback in a Hybrid Environment
Gathering Feedback in a Hybrid EnvironmentGathering Feedback in a Hybrid Environment
Gathering Feedback in a Hybrid EnvironmentTechSoupConnectLondo
 
Internal comms - building guiding principles and choosing the right tools
Internal comms - building guiding principles and choosing the right toolsInternal comms - building guiding principles and choosing the right tools
Internal comms - building guiding principles and choosing the right toolsCharityComms
 
Adding Snap, Crackle & Pop to Chapter Events
Adding Snap, Crackle & Pop to Chapter EventsAdding Snap, Crackle & Pop to Chapter Events
Adding Snap, Crackle & Pop to Chapter EventsBillhighway
 
NTEN 2010 25 ways to increase communications
NTEN 2010 25 ways to increase communicationsNTEN 2010 25 ways to increase communications
NTEN 2010 25 ways to increase communicationsmksutts
 
Recruiting Professional Volunteers
Recruiting Professional VolunteersRecruiting Professional Volunteers
Recruiting Professional Volunteers4Good.org
 

Similar to Entry points and guide posts: Helping contributors find their way (20)

Engineering content-champions-todd-stc-2017
Engineering content-champions-todd-stc-2017Engineering content-champions-todd-stc-2017
Engineering content-champions-todd-stc-2017
 
Drive Member Engagement through Revitalized Chapter Events
Drive Member Engagement through Revitalized Chapter EventsDrive Member Engagement through Revitalized Chapter Events
Drive Member Engagement through Revitalized Chapter Events
 
August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...
August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...
August BPN - Professional Development: Using Your Skills to Get Ahead and Hel...
 
Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...
Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...
Why Your Dashboard Sucks: Applications of Design Thinking in Enterprise Busin...
 
Get it right the first time - AJ Davis - Product Camp Austin 2018
Get it right the first time - AJ Davis - Product Camp Austin 2018Get it right the first time - AJ Davis - Product Camp Austin 2018
Get it right the first time - AJ Davis - Product Camp Austin 2018
 
Disruptive Innovation: How fresh thinking can propel your small business forw...
Disruptive Innovation: How fresh thinking can propel your small business forw...Disruptive Innovation: How fresh thinking can propel your small business forw...
Disruptive Innovation: How fresh thinking can propel your small business forw...
 
Harnessing Your Experts’ Knowledge for Sustainable Competitive Advantage
Harnessing Your Experts’ Knowledge for Sustainable Competitive AdvantageHarnessing Your Experts’ Knowledge for Sustainable Competitive Advantage
Harnessing Your Experts’ Knowledge for Sustainable Competitive Advantage
 
More Than a Feeling: Data-Informed Design
More Than a Feeling: Data-Informed DesignMore Than a Feeling: Data-Informed Design
More Than a Feeling: Data-Informed Design
 
Elicitation Techniques
Elicitation TechniquesElicitation Techniques
Elicitation Techniques
 
Social Learning Tactics for Learning Designers
Social Learning Tactics for Learning DesignersSocial Learning Tactics for Learning Designers
Social Learning Tactics for Learning Designers
 
Chapter Engagement: 5 Trends for 2017
Chapter Engagement: 5 Trends for 2017Chapter Engagement: 5 Trends for 2017
Chapter Engagement: 5 Trends for 2017
 
How to create effective and optimized content by jen silverman
How to create effective and optimized content by jen silvermanHow to create effective and optimized content by jen silverman
How to create effective and optimized content by jen silverman
 
Design Upstream
Design UpstreamDesign Upstream
Design Upstream
 
Getting Started with Higher Ed Web Governance kickstarter guide
Getting Started with Higher Ed Web Governance kickstarter guideGetting Started with Higher Ed Web Governance kickstarter guide
Getting Started with Higher Ed Web Governance kickstarter guide
 
Collaboration from the Trenches : Building your Internal Communities with Mic...
Collaboration from the Trenches : Building your Internal Communities with Mic...Collaboration from the Trenches : Building your Internal Communities with Mic...
Collaboration from the Trenches : Building your Internal Communities with Mic...
 
Gathering Feedback in a Hybrid Environment
Gathering Feedback in a Hybrid EnvironmentGathering Feedback in a Hybrid Environment
Gathering Feedback in a Hybrid Environment
 
Internal comms - building guiding principles and choosing the right tools
Internal comms - building guiding principles and choosing the right toolsInternal comms - building guiding principles and choosing the right tools
Internal comms - building guiding principles and choosing the right tools
 
Adding Snap, Crackle & Pop to Chapter Events
Adding Snap, Crackle & Pop to Chapter EventsAdding Snap, Crackle & Pop to Chapter Events
Adding Snap, Crackle & Pop to Chapter Events
 
NTEN 2010 25 ways to increase communications
NTEN 2010 25 ways to increase communicationsNTEN 2010 25 ways to increase communications
NTEN 2010 25 ways to increase communications
 
Recruiting Professional Volunteers
Recruiting Professional VolunteersRecruiting Professional Volunteers
Recruiting Professional Volunteers
 

Recently uploaded

OpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full Recording
OpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full RecordingOpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full Recording
OpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full RecordingShane Coughlan
 
Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...
Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...
Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...OnePlan Solutions
 
2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf
2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf
2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdfAndrey Devyatkin
 
Copilot para Microsoft 365 y Power Platform Copilot
Copilot para Microsoft 365 y Power Platform CopilotCopilot para Microsoft 365 y Power Platform Copilot
Copilot para Microsoft 365 y Power Platform CopilotEdgard Alejos
 
SAM Training Session - How to use EXCEL ?
SAM Training Session - How to use EXCEL ?SAM Training Session - How to use EXCEL ?
SAM Training Session - How to use EXCEL ?Alexandre Beguel
 
eSoftTools IMAP Backup Software and migration tools
eSoftTools IMAP Backup Software and migration toolseSoftTools IMAP Backup Software and migration tools
eSoftTools IMAP Backup Software and migration toolsosttopstonverter
 
Large Language Models for Test Case Evolution and Repair
Large Language Models for Test Case Evolution and RepairLarge Language Models for Test Case Evolution and Repair
Large Language Models for Test Case Evolution and RepairLionel Briand
 
Enhancing Supply Chain Visibility with Cargo Cloud Solutions.pdf
Enhancing Supply Chain Visibility with Cargo Cloud Solutions.pdfEnhancing Supply Chain Visibility with Cargo Cloud Solutions.pdf
Enhancing Supply Chain Visibility with Cargo Cloud Solutions.pdfRTS corp
 
GraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4j
GraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4jGraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4j
GraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4jNeo4j
 
Keeping your build tool updated in a multi repository world
Keeping your build tool updated in a multi repository worldKeeping your build tool updated in a multi repository world
Keeping your build tool updated in a multi repository worldRoberto Pérez Alcolea
 
Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...
Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...
Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...OnePlan Solutions
 
Ronisha Informatics Private Limited Catalogue
Ronisha Informatics Private Limited CatalogueRonisha Informatics Private Limited Catalogue
Ronisha Informatics Private Limited Catalogueitservices996
 
Understanding Flamingo - DeepMind's VLM Architecture
Understanding Flamingo - DeepMind's VLM ArchitectureUnderstanding Flamingo - DeepMind's VLM Architecture
Understanding Flamingo - DeepMind's VLM Architecturerahul_net
 
VictoriaMetrics Q1 Meet Up '24 - Community & News Update
VictoriaMetrics Q1 Meet Up '24 - Community & News UpdateVictoriaMetrics Q1 Meet Up '24 - Community & News Update
VictoriaMetrics Q1 Meet Up '24 - Community & News UpdateVictoriaMetrics
 
Strategies for using alternative queries to mitigate zero results
Strategies for using alternative queries to mitigate zero resultsStrategies for using alternative queries to mitigate zero results
Strategies for using alternative queries to mitigate zero resultsJean Silva
 
Data modeling 101 - Basics - Software Domain
Data modeling 101 - Basics - Software DomainData modeling 101 - Basics - Software Domain
Data modeling 101 - Basics - Software DomainAbdul Ahad
 
Zer0con 2024 final share short version.pdf
Zer0con 2024 final share short version.pdfZer0con 2024 final share short version.pdf
Zer0con 2024 final share short version.pdfmaor17
 
Simplifying Microservices & Apps - The art of effortless development - Meetup...
Simplifying Microservices & Apps - The art of effortless development - Meetup...Simplifying Microservices & Apps - The art of effortless development - Meetup...
Simplifying Microservices & Apps - The art of effortless development - Meetup...Rob Geurden
 
UI5ers live - Custom Controls wrapping 3rd-party libs.pptx
UI5ers live - Custom Controls wrapping 3rd-party libs.pptxUI5ers live - Custom Controls wrapping 3rd-party libs.pptx
UI5ers live - Custom Controls wrapping 3rd-party libs.pptxAndreas Kunz
 
The Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptx
The Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptxThe Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptx
The Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptxRTS corp
 

Recently uploaded (20)

OpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full Recording
OpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full RecordingOpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full Recording
OpenChain AI Study Group - Europe and Asia Recap - 2024-04-11 - Full Recording
 
Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...
Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...
Tech Tuesday Slides - Introduction to Project Management with OnePlan's Work ...
 
2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf
2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf
2024-04-09 - From Complexity to Clarity - AWS Summit AMS.pdf
 
Copilot para Microsoft 365 y Power Platform Copilot
Copilot para Microsoft 365 y Power Platform CopilotCopilot para Microsoft 365 y Power Platform Copilot
Copilot para Microsoft 365 y Power Platform Copilot
 
SAM Training Session - How to use EXCEL ?
SAM Training Session - How to use EXCEL ?SAM Training Session - How to use EXCEL ?
SAM Training Session - How to use EXCEL ?
 
eSoftTools IMAP Backup Software and migration tools
eSoftTools IMAP Backup Software and migration toolseSoftTools IMAP Backup Software and migration tools
eSoftTools IMAP Backup Software and migration tools
 
Large Language Models for Test Case Evolution and Repair
Large Language Models for Test Case Evolution and RepairLarge Language Models for Test Case Evolution and Repair
Large Language Models for Test Case Evolution and Repair
 
Enhancing Supply Chain Visibility with Cargo Cloud Solutions.pdf
Enhancing Supply Chain Visibility with Cargo Cloud Solutions.pdfEnhancing Supply Chain Visibility with Cargo Cloud Solutions.pdf
Enhancing Supply Chain Visibility with Cargo Cloud Solutions.pdf
 
GraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4j
GraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4jGraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4j
GraphSummit Madrid - Product Vision and Roadmap - Luis Salvador Neo4j
 
Keeping your build tool updated in a multi repository world
Keeping your build tool updated in a multi repository worldKeeping your build tool updated in a multi repository world
Keeping your build tool updated in a multi repository world
 
Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...
Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...
Revolutionizing the Digital Transformation Office - Leveraging OnePlan’s AI a...
 
Ronisha Informatics Private Limited Catalogue
Ronisha Informatics Private Limited CatalogueRonisha Informatics Private Limited Catalogue
Ronisha Informatics Private Limited Catalogue
 
Understanding Flamingo - DeepMind's VLM Architecture
Understanding Flamingo - DeepMind's VLM ArchitectureUnderstanding Flamingo - DeepMind's VLM Architecture
Understanding Flamingo - DeepMind's VLM Architecture
 
VictoriaMetrics Q1 Meet Up '24 - Community & News Update
VictoriaMetrics Q1 Meet Up '24 - Community & News UpdateVictoriaMetrics Q1 Meet Up '24 - Community & News Update
VictoriaMetrics Q1 Meet Up '24 - Community & News Update
 
Strategies for using alternative queries to mitigate zero results
Strategies for using alternative queries to mitigate zero resultsStrategies for using alternative queries to mitigate zero results
Strategies for using alternative queries to mitigate zero results
 
Data modeling 101 - Basics - Software Domain
Data modeling 101 - Basics - Software DomainData modeling 101 - Basics - Software Domain
Data modeling 101 - Basics - Software Domain
 
Zer0con 2024 final share short version.pdf
Zer0con 2024 final share short version.pdfZer0con 2024 final share short version.pdf
Zer0con 2024 final share short version.pdf
 
Simplifying Microservices & Apps - The art of effortless development - Meetup...
Simplifying Microservices & Apps - The art of effortless development - Meetup...Simplifying Microservices & Apps - The art of effortless development - Meetup...
Simplifying Microservices & Apps - The art of effortless development - Meetup...
 
UI5ers live - Custom Controls wrapping 3rd-party libs.pptx
UI5ers live - Custom Controls wrapping 3rd-party libs.pptxUI5ers live - Custom Controls wrapping 3rd-party libs.pptx
UI5ers live - Custom Controls wrapping 3rd-party libs.pptx
 
The Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptx
The Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptxThe Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptx
The Role of IoT and Sensor Technology in Cargo Cloud Solutions.pptx
 

Entry points and guide posts: Helping contributors find their way

  • 1. Entry points & guide posts: Helping contributors find their way Janet Swisher Community Manager, Mozilla Developer Network @jmswisher
  • 2. 2
  • 3. What the heck am I talking about? open documentation Docs, internal or external, that people outside your team can modify contributor Anyone who modifies your docs who doesn't have "Technical writer for {your_team_name}" in their job description Background: http://www.slideshare.net/janetswisher 3
  • 4.
  • 5. How to drive people away 5
  • 6. Ways to encourage contribution Strategy Tactic Streamline the path from interest to success More-focused Getting Started page Create invitations, not roadblocks Show non-English readers what's not translated Expose what areas need help, in what ways Doc status pages for topics and locales 6
  • 8.
  • 9.
  • 10.
  • 11.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17. Expose what areas need help, in what ways
  • 18.
  • 19.
  • 20.
  • 21. Results over time Data are noisy; direct cause and effect is hard to prove. But we seem to be doing something right. 21
  • 22. Do it yourself •  Streamline the path from interest to success •  Create invitations, not roadblocks •  Expose opportunities •  What needs to be done •  How to do it Improve the CX (Contributor Experience) 22
  • 23. Plain old UX work is good too 23
  • 24. Continue the conversation on Twitter: @jmswisher Thanks! Discuss!