I usually avoid tasks involving CI/CD pipelines, but I managed to create some cool automation (despite occasionally yelling at my screen 😀).

1. Using Tapir, I built an sbt task to generate OpenAPI specs.

2. The release job executes this task, uploading the YAML to our MkDocs-based knowledge base.

3. The Swagger UI plugin now lets everyone view service APIs without checking production's /docs endpoints.

Time to buy the author of the plugin coffee 🙌