Full-day API The Docs track at APIdays Paris 2019

The API Docs & DX track 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. It is a great opportunity to share and discuss the latest best practices, strategies and new trends relevant to API documentation and developer portals!

APIdays Paris, the main event

APIdays Paris is about all recent technologies and business models associated to APIs. 100+ speakers will be invited to speak and share their experience regarding "From Legacy to Agile, From Product to Ecosystems".

Day 1 will focus on the technological aspect of APIs, with talks and keynotes about REST, GraphQL, gRPC, Serverless, OpenAPISpec/Swagger, Kafka, Docker, Kubernetes, Kong, Kubernetes, OAuth, OpenId Connect, JWT etc. There will be 5 tracks, with API Documentation & Developer Experience being one of them!

Code of Conduct

APIdays, through its series of conference, research and educational activities is dedicated to providing a harassment-free experience for participants at all of our events. APIdays events are deigned for professional networking and collaboration within the API community. Its guiding principle is to foster the open exchange of ideas and expression and require an environment that recognizes the inherent worth of every person and group. Any participants, including members, speakers, attendees, volunteers, sponsors, exhibitors, booth staff and anyone else, should not engage in harassment in any form.
Full version is available here.

CFP of the Docs & DX track is open


We're still looking for speakers, so if you have a story to share, submit it through the APIdays form and also ping us at info@apithedocs.org until the end of October.


Barry Rosenberg profile image
Technical Writing Courses
Sharif Salah profile image
Technical Writing Courses
Ben Ahmady profile image
Write the API Docs Before the API Exists
Adeel Ali profile image
Increasing API Adoption via Code PlayGround
Oliver Thamm profile img
API Accessibility - Key Concepts driving Developer Adoption
Jaap Brasser profile
API SDK Development: Lessons Learned
Julia Elman
Ad Hoc
Designing APIs for Humans: Leveraging UX Methods For Develop Human Centered APIs
Ilona Koren-Deutsch profile image
Lessons Learned from Rebuilding a Developer Documentation Website
Prabhjot Singh profile image
Lessons Learned from Rebuilding a Developer Documentation Website
Nathaniel Okenwa profile image
A Balanced Diet of Documentation
Mike Budzynski profile image
Microsoft Azure
Six Principles of the Next Generation Developer Portal
Kenigbolo Meya Stephen profile image
Continuous Documentation - The Best Time is Now
Gregory De Jans profile image
Grow Your Developer Community by Enhancing the Developer Portal Experience
Kristof Van Tomme profile image
Scaling API Docs: A Role for Developer Portals in Digital Transformation



11:00-11:25 Oliver Thamm: API Accessibility - Key Concepts Driving Developer Adoption
How do API access methods influence developer adoption? Do they provide a SDK, design a REST (Hypermedia) API, integrate with adapter frameworks? Making those decisions has an underestimated effect on developer adoption. As well, learn about the influence of: authentication methods, output formats, OSS standards, design, documentation, etc.
11:25-11:50 S. Adeel Ali: Increasing API Adoption via Code PlayGround
This session will elucidate what is an API Code PlayGround, and how does it create a phenomenal developer experience.
11:50-12:15 Jaap Brasser: API SDK Development - Lessons Learned
Building a solid API is a challenge but getting our APIs to be adopted by a larger audience, we quickly realized that having solid SDKs is the key element.
12:15-12:40 Julia Elman: Designing APIs for Humans: Leveraging UX Methods For Develop Human Centered APIs
This talk is focused on how we leverage human centered design in the civic tech space to create robust and meaningful APIs that help meet Veterans needs. It focuses on teaching how to collaborate cross discipline to create a healthy API ecosystem.
12:40-14:00 Lunch break
Grab your lunch in the sponsor area.
14:00-14:25 Kristof Van Tomme: Scaling API Docs: A Role for Developer Portals in Digital Transformation
Developer experience is a key predictor for a successful API program. But how do you go about making a great DX at scale? If you are a startup there are many models in the API community you can emulate. But what if you are running a large API initiative as part of a digital transformation program, how will you do so consistently at scale? What are the pitfalls? What should you consider when choosing the governance model and technology for your devportal?
14:25-14:50 Mike Budzynski: Six Principles of the Next Generation Developer Portal
At Microsoft Azure API Management, we took up a challenge of building the next generation developer portal for thousands of our customers. We distilled the essence of developer portals by rethinking their purpose, collecting customers’ feedback, and researching the trends and available solutions. Then, we built our new developer portal based on these findings
14:50-15:15 Gregory De Jans: Grow Your Developer Community by Enhancing the Developer Portal Experience
Many companies are still looking at a developer portal solely as a delivery channel which allows customers to access their APIs. But a good developer portal needs to provide much more than this. It should allow developers to easily discover, evaluate and use your products in real life applications. It should also serve as a community where developers can connect with each other, one to many and one to one. Companies must not only facilitate this connection but also engage as a participating member both online and offline, to create a 360-degree experience comprised of everything from an API portal, product management and product marketing, marketing channels and programs and content, to customer support, inside sales, developer relations, and insight and analytics for continuous improvement. To gain developers’ trust and grow their developer community, companies need to contribute, tech, amplify and befriend.
15:15-15:40 Ilona Koren-Deutsch & Prabhjot Singh: Lessons Learned From Rebuilding a Developer Documentation Website
Learn what went well and what didn’t, when Ilona, a technical writer, and Prabhjot, a software engineer, share the story of revamping the developer documentation website at Twitch.
15:40-16:15 Break
Grab a coffee in the sponsor area.
16:15-16:40 Nathaniel Okenwa: A Balanced Diet of Documentation
Documentation isn’t always straightforward. Tutorials, QuickStarts, References. It can be difficult to know where to start.
16:40-17:05 Ben Ahmady: Write the API docs before the API exists
This talk proposes to discuss a recent experiment we at Onfido undertook which took a novel approach: "write the docs before the API exists".
17:05-17:30 Kenigbolo Meya Stephen: Continuous Documentation - The best time is now
Bad or non existent documentations are almost always the ripple effect of not writing documentation when it matters. In this talk I’ll take a quick deep dive into the importance of “Continuous Documentation” and how this is important for creating an amazing developer experience.
17:30-17:55 Barry Rosenberg & Sharif Salah: Technical Writing Courses
Google introduced technical writing classes for its engineers a few years ago. Since then, thousands of Google engineers have taken and loved these classes. The courses improve the technical writing skills of engineers through focused writing exercises and peer review.


Beffroi de Montrouge 2 Place Emile Cresp, 92120 Montrouge


Social Media