The Getting Stopped Experience: Improving Your Content’s First Impression


The “Getting Started” page of your product is the most important page for bringing new people onto your product. In the best case, it introduces readers to your product and convinces them to use it. Too often, though, it becomes the “Getting Stopped” experience, with readers getting repeatedly frustrated. Poor documentation, from the Getting Started page on, causes many developers to leave your content and product behind. Outdated information, rude warnings, bad metrics, and poor content strategy all contribute to the “Getting Stopped” experience.

This talk examines several practical solutions that tech writers can use to engage readers and create a better first impression. Drawing on examples from Google’s Cloud developer documentation, I focus on how users can define solid metrics for success and encourage reader participation. With these simple but robust solutions, you too can bring more people to your product, getting them started and keeping them around.