MAP-94: improve swagger docs.