OpenAPI & API design

Go Time: Golang, Software Engineering

We’re talking OpenAPI this week! Kris & Johnny are joined by Jamie Tanna, one of the maintainers of oapi-codegen, to discuss OpenAPI, API design philosophies, versioning, and open source maintenance and sustainability. In addition to the usual laughs and unpopular opinions, this week’s episode includes a Changelog++ section that you don’t want to miss.

Join the discussion

Changelog++ members get a bonus 18 minutes at the end of this episode and zero ads. Join today!

Sponsors:

• Coder.com – Instantly launch fully configured cloud development environments (CDE) and make your first commit in minutes. No need to traverse README files or await onboarding queues. Learn more at Coder.com

Featuring:

• Jamie Tanna – Website, GitHub, LinkedIn, Mastodon, X
• Kris Brandow – GitHub, X
• Johnny Boursiquot – Website, GitHub, X

Show Notes:

• oapi-codegen is moving to its own org
• Creating a more sustainable model for oapi-codegen in the future
• I’m Now A Full-time Profession Open Source Maintainer
• Does the tech industry thrive on free work?
• Jamie’s GitHub Sponsors Profile
• How do you represent a JSON field in Go that could be absent, null or have a value?
• APIs as infrastructure: future-proofing Stripe with versioning
• Common Haus
• Workflow
• Introduction to OpenRewrite
• OpenAPI Changes
• quobix.com
• pb33f.io

Something missing or broken? PRs welcome!

Chapter

1. It's Go Time! (00:00:00)

2. Sponsor: Coder.com (00:00:40)

https://coder.com/

3. Welcoming Jamie Tanna (00:04:18)

https://www.jvt.me

4. OpenAPI (00:05:58)

5. oapi-codegen (00:08:29)

6. Code maliability (00:10:59)

7. Why use this? (00:15:58)

8. Read-me driven development (00:19:58)

9. Managing versions (00:23:06)

10. Versioning your APIs (00:26:30)

11. Open rewrite (00:38:45)

12. Maintaining (00:49:45)

13. Email bankruptcy (00:56:12)

14. Unpopular Opinions! (01:06:43)

15. Jamie's unpop (01:07:23)

16. Jamie's 2nd unpop (01:09:54)

17. Outro (join ++!) (01:12:23)

https://changelog.com/++