Hasta ahora puedes encontrar diferentes cosas en este blog para una configuración básica de swagger como herramienta para documentar tus APIs.
Con esta entrada vas a darle algo mas de riqueza a la documentación sobre tus servicios. Con aspectos como «Implementation Notes» o el tipo devuelto por la respuesta en caso de tener 200 o diferentes códigos de error.