Large-scale REST API Doc Solution | Kelsey Lambert, Sejal Parikh | API The Docs Amsterdam 2019

"An Inside Look at a Large-scale Writer-driven REST API Doc Solution at Salesforce" by Kelsey Lambert, Sejal Parikh, API The Docs Amsterdam 2019

Talk Description:
"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."

---

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.