July 17-19 | Tokyo, Japan
View More Details  & Register Here
Back To Schedule
Wednesday, July 17 • 14:20 - 15:00
From User to Contributor: How Documentation Enables Vibrant Open Source Communities - Riona MacNamara, Google

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Feedback form is now closed.
Documentation grows adoption and supports development - and, critically, detailed, accurate documentation of a project's architecture, processes, and governance empowers community members to become contributors. Yet too often, documentation is neglected, incomplete, stale, or hard to find - and that hurts everybody. In Q1 2019, Google's Open Source Strategy team commissioned a study to better understand why users do (or do not) contribute back to the project, and how documentation can empower and engage those users.

This talk will cover the methodology and participant profiles of the study, and describe the critical user journeys of three essential user personas. It distills the research to provide concrete, actionable recommendations and best practices for creating documentation that supports your project's users and grows your contributor base.

avatar for Riona MacNamara

Riona MacNamara

Senior staff technical writer, Google
Riona is senior staff technical writer at Google, where she has worked for 11 years, and is focused on open source documentation strategy. She previously led the team that builds g3doc, Google's internal platform for engineering documentation, used by thousands of projects within... Read More →

Wednesday July 17, 2019 14:20 - 15:00 JST
Hall B (4) (Floor 4F)
  Open Source Leadership
  • Experience Level Any