Right, this is something of a collision between swagger terminology and my own thinking, where I'm calling the complete list of swagger resources the spec, but swagger calls the definition of a single resource a spec. I'll try to clean up the comments to make it more sensible.