entry points and guide posts: helping contributors find their way
TRANSCRIPT
Entry points & guide posts:Helping contributors find
their wayJanet Swisher
Community Manager, Mozilla Developer Network
@jmswisher
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
Ways to encourage contribution
Strategy Tactic
Streamline the path frominterest to success
More-focused Getting Started page
Create invitations, notroadblocks
Show non-English readers what'snot translated
Expose what areas need help, inwhat ways
Doc status pages for topics andlocales
6
Streamline thepath frominterest tosuccess
Results over time
Data are noisy; direct cause and effect is hard to prove. But we seem tobe 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