It took me a little while to get what this first sentence was saying because I interpreted 'calls' as an action. I think this might be clearer:

`// A "model" in Swagger is a schema for JSON object. This object holds all the models that have been described using the @RESTModel documentation annotation. Once registered, REST endpoint documentation can refer to these as input parameter types and return types`