Building a Better Web
June 19–20, 2017: Training
June 20–22, 2017: Tutorials & Conference
San Jose, CA

To cross the chasm, you need docs: A Docker story

Joao Fernandes (Docker)
3:35pm–4:15pm Thursday, June 22, 2017
People and teams
Location: 210 BF
Secondary topics:  Building great teams, Case studies and comparisons, Maintaining sites and applications
Average rating: ***..
(3.75, 4 ratings)

Who is this presentation for?

  • Developers, team leads, and managers

What you'll learn

  • Understand why you need good docs for having massive product adoption and how a lack of docs can drain your engineering resources
  • Explore Docker's docs team, the skills it values, and the tools it uses to document and serve


If you’ve worked in the tech industry for a while, you know that getting early adopters is hard, but bringing your product to the rest of the world is harder. Known as crossing the chasm, this is a make-or-break moment for many products and companies—Docker included. Joao Fernandes explains how good docs can help you cross the chasm and ensure you won’t need to spend your days holding users’ hands and shares the processes and tools Docker uses to deliver docs in a continuous way.

Topics include:

  • Why you need good docs for massive product adoption
  • How a lack of docs can drain your engineering resources
  • How Docker’s docs team is structured and the skills it values
  • The tools the team uses to document and serve
  • How GitHub and open source allow Docker to receive tons of contributions
Photo of Joao Fernandes

Joao Fernandes


Joao Fernandes is the documentation lead for Docker Datacenter, where his responsibilities include working side by side with designers and developers on all stages of product development to ensure Docker Datacenter is easy to learn and use and helping to shape the team processes, roadmap, and hiring interviews. Previously, Joao was a senior academy engineer at Outsystems, where he worked on docs, training, curriculum development, and usability studies. Joao holds an MSc and BSc in computer science. You can read his blog at