Swagger

just to preview the changes needed to use swagger
Unfortunate that you have to duplicate this everywhere. :-(