added comments to methods, removed response classes from swagger-ui (not
useful atm)