For companies that have a public API, having a great developer experience is the key to winning business. Your technical documentation is the main driver in developer’s purchasing decisions, but having excellent tooling plays a close second.
In this session, we’ll deep dive into how and why HelloSign migrated our public API to the OpenAPI spec and how that powers our documentation and SDKs. We’ll dig into specific challenges we faced during the migration and working with various tools for automatic generation. We’ll also share the impact we’ve observed on our customers after we made the switch. You’ll leave with a better understanding of the OpenAPI spec, how it can be used to power exceptional developer experience, and some of the tradeoffs you might encounter if you decide to use it.

I work on the "API Pod" at HelloSign (Dropbox) and own developer experience. In early 2022 we migrated to OpenAPI and use that to power our documentation and all our SDKs. This is one of a few talk ideas that explore the same topic from different lenses.