Mike Ralphson

Thank you, much appreciated!

Hmm, I'm not 100% sure about this. Let me have a think about why the original headings were chosen. It might make sense to make this change for when AsyncAPI...

The current strategy at least copes with arbitrary JSON schemas of any complexity. I think it might be hard to determine which schemas were candidates for a more compact representation....

I think your second point is a dupe of #156

No ETA at the moment, I'm afraid. Pull requests would be very welcome!

Generally unless an issue is tied to a milestone with a date on it, then there is no ETA. I'll try and take a look at what's (not) going on...

@manuelhartl do you mean `openapi-generator`? That's a completely separate project.

`--expandBody` and `--omitBody` are (as you might be able to guess from their names / descriptions) mutually exclusive options. I might be able to make this explicit using the `yargs`...

If you put the external `$ref`s in `/components/schemas` and use internal `$ref`s from each usage into `/components/schemas` you should be able to work-around this behaviour.

Your de-referenced schemas show as `Inline` because that's exactly how they have been replaced by the `--resolve` option. I.e. the contents of the file/fragment `$ref`ed has been inserted at the...