schema tool does not pull the top level comment on the resource.

[n3wscott]

This one:

      openAPIV3Schema: &openAPIV3Schema
        description: 'some comment on the toplevel struct'
        type: object
           ....