Let Writers Write:Automating the Boring Stuff for Our Docs Team | Patrick Hammond | ATD Virtual 2020
Channel: API the Docs
Date: 2020-11-12

Let Writers Write:Automating the Boring Stuff for Our Docs Team by Patrick Hammond, API The Docs Virtual 2020

Talk Description:

We got into technical writing to make complex things seem simple, not to be janitors. So why do we spend so much of our time on maintenance? We fix broken links, find missing images, remove sensitive information... and that's only if we know these problems exist! Worst of all, we manually create and update code samples. Broken code samples are useless at best, and downright maddening at worst. Developer experience is really important to Adyen, and we got sick of seeing code samples become inconsistent and inaccurate.

In this talk, Patrick Hammond will explain how Adyen approached the problem of creating, updating, and testing code samples. He'll discuss the solution they created, and how it works for their team. He'll also delve into some other common bugbears that Adyen are automating away, much to the delight of their 8 technical writers.

API The Docs Virtual 2020 recaps: https://pronovix.com/event/api-docs-virtual-2020

---

API the Docs is an event for tech writers, API developers, product owners and developer evangelists who embrace documentation as a crucial aspect of a great developer experience. The conference is a great opportunity to share and discuss the latest best practices, strategies and new trends relevant to API documentation and developer portals.

Pronovix Developer Portals Newsletter:  http://bit.ly/devportals