Good write up. The Swagger standard and tooling is great for defining and documentating API's. It's implementation agnostic and works with most APIM's such as Azure, APIGee (Google) or MuleSoft. Here is an example tutorial I think you will like.
https://support.smartbear.com/swaggerhub/docs/tutorials/openapi-3-tutorial.html