Automating API Changelogs: How to improve API developer experience

Video Description

API products should change to adapt to changing needs and consumer groups. But how do you make changes without disrupting existing consumers? Avoiding breaking changes is a good idea, and documenting all changes in an easily consumable changelog is another good idea. Bianca Lisle of @MongoDB explains how to document API changes. Part of the challenge is to make sure that existing consumers of the API know what's going on. Another challenge is to make sure that the process of generating SDKs wasn't affected by changes in the API. All of this is made possible by tracking and managing API changes in an automated way: 👉 Atlas API Changelog - https://www.mongodb.com/docs/atlas/reference/api-resources-spec/changelog/ 👉 Meet the APIx Team at MongoDB - https://www.mongodb.com/blog/post/serving-digital-bridge-meet-apix-team-mongodb I'd like to thank Reuven Harrison of oasdiff for connecting me with Bianca Lisle. It's always interesting to hear about new tools and practices in the API space, but it's even better to see these tools and practices in action in real-life scenarios. You can find all the tooling discussed in this video at the following links: 👉 oasdiff Home Page - https://www.oasdiff.com/ 👉 oasdiff Changelogs - https://www.oasdiff.com/home/changelog 👉 oasdiff GitHub repo - https://github.com/tufin/oasdiff #api #apimanagement #changemanagement #changelog #developerexperience #dx #apidocumentation #documentation #apiplatform #gettingapistowork #digitaltransformation