It came up a lot in the Docker Remote API rework discussions: moby/moby#15188 moby/moby#5893 I also think swagger is a great way to describe APIs.

If there's a way maybe we can declare types/* in swagger specs and generate source files using swagger code generators, that would be very preferable as other language SDKs can take advantage of the swagger specs as well.

Just leaving this here.