Adam Altman

@jeremyfiel heads up: I removed the assertions docs yesterday and made this issue #647. We'll release the docs once this change is made. You raise some good issues, and I'll...

Side note: @austpaul have you reported the bugs in rc.72 or are existing bug issues opened?

Thanks @austpaul -- looks like we fixed that yesterday.

I agree. I went up with two tabs of terminal running to do this now. And our docs are very forgiving, so it's easy to not see a mistake in...

Now that we have a VS Code extension, I find this less necessary (personally). If you don't use VS Code, this would still be important.

@gregorysimpson13 what version of OAS? I opened #339 before...

Thanks @TejasQ for raising the issue and providing a solution. The path item object can also have a `parameters` object at the top level. https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#path-item-object We should solve that as...

 (We're deep into some other projects, and I hope we can get to this within a few weeks. I'll see if anyone else on the team can hop in.)

I think the options should match the UI more: --skip-api-docs-primary --skip-api-docs-previews

I don't think this is a bug bundling (perhaps a bug linting). Source: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#componentsObject Excerpt from the OpenAPI definition: ```yaml components: schemas: $ref: "./schemas/_index.yaml" parameters: $ref: "./parameters/_index.yaml" ``` In the...