15:00-15:30 Kelsey Lambert, Sejal Parikh: An Inside Look at a Large-scale Writer-driven REST API Doc Solution at Salesforce

How can writers drive developer documentation initiatives at a large company? At Salesforce, we have 23 REST APIs that span 26+ teams and 150+ writers. API doc is published in 10 different dev doc environments. Our customers, developers, and writers are demanding a modern and unified solution for our REST API docs.

At a company as large as Salesforce, it’s challenging to align on a strategy and make traction at scale. In June 2018, a group of developer-focused writers teamed up to tackle this problem using the OpenAPI standard. With no official funding or allocation for this project, but with the generous support of our managers, we’ve developed a REST API doc solution across multiple teams. We have earned the trust of executives and engineering teams across Salesforce along the way.

In this session, we share our story of how we got there, with the hope of empowering other writers to tackle projects that feel impossible right now.