All Things Swagger

I tried to add a picture of swagger and you can see the results on the right. The way this thing is set up is not intuitive to my poor api developer brain