Discovering API Version differences with ease

on YouTube ↗23m

" summary

Built a custom comparison framework that ingests OpenAPI/Swagger specs and flags breaking changes, moved endpoints and status/body/parameter alterations, then maps those diffs to SDK files using regex and AST so specific lines to change are identified; outputs include Markdown, JSON and HTML and it auto-creates GitHub issue automation for regressions. Changelogs once spanned 1700-page changelogs, automation handles most cases but complex tree moves require tailored if/else logic and manual fixes.

AI-written summary · about

" chapters (7)

1. 0:00Intro
2. 1:28Use case
3. 3:42Different types of users
4. 8:52What is your goal
5. 12:22What are the outputs
6. 14:42What we learned
7. 18:30Questions

" related talks

• 24mBreaking the Interface - API Versioning with REST, JSON and SwaggerThomas Bayer · apidays Helsinki 2019
• 35mDocumenting APIs: new era, same craftJavier Rubio · Write the Docs Berlin 2026
• 21mIntroducing The API LifecycleAndreas Krohn · Nordic APIs World Tour 2015
• 09mGSoC: Generating diffs using AsyncAPI DiffAayush Sahu · AsyncAPI Conference 2021
• 44mSeamless Upgrades: Mastering API CompatibilityNaresh Jain · Appium Conf 2024
• 34mShuffle ball change: Sashay your way to clearer API documentationRachael Stavchansky · Write the Docs Portland 2021
• 06mKeynote: APIs, the Universe, and EverythingVijoy Pandey · KubeCon + CloudNativeCon North America 2021
• 39mAPI Development in 2017Takafumi ONAKA · RubyKaigi 2017