I am working on a project that is using java annotations for swagger 1.5. We are looking at improving the information in our documentation i.e. is it correct and can we make
