WriteTheDocs India Nov 09 2019 - Large scale REST API Doc Solution by Sejal Parikh
Channel: Write The Docs Podcast & Meetups
Date: 2020-06-23

Large scale REST API Doc Solution by Sejal Parikh at WTDIndia Meetup, Nov 2019

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

About the talk: 
How can writers drive developer documentation initiatives at a large company? At Salesforce, they have 23 REST APIs that span 26+ teams and 150+ writers. API doc is published in 10 different dev doc environments. Their 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 their managers, they’ve developed a REST API doc solution across multiple teams. They have earned the trust of executives and engineering teams across Salesforce along the way.

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

Join WTDIndia Meetups at https://www.meetup.com/Write-the-Docs-India/