Sejal Parikh profile image

Sejal Parikh

Salesforce

An Inside Look at a Large-scale Writer-driven REST API Doc Solution

Biography

Sejal carries 14 years of experience as a telecom engineer, software tester, and technical writer. She has been with Salesforce for seven months and is currently working as a product owner for developer-centric content, with a focus on automating the documentation processes for writers.

Talk description

23 different REST APIs, 26+ teams, 150+ writers — how we built a unified solution. In this session, hear the inside story of how a handful of writers developed a REST API doc solution and earned the trust of executives and engineering teams across Salesforce along the way.

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.