Darrel

I don't know what the answer is. The rewrite rules do seem to be working for me at the moment but I have not tested extensively. I do think that...

Yeah, I also discovered the issue with tags. Although for some strange reason posts are working for me.

I knew we were going to get bitten by something like this sooner or later. As far as I know there is no official way to do this. I suspect...

@handrews Yeah, it would work to say style=simple can only be used in the query if it is the only query parameter.... but yuck. How many more of these ugly...

We are open to adding some clarification if someone can suggest a clean annotation markup to the spec. Should we duplicate the constraint in the each of the property descriptions?...

We have attempted to be explicit about where $ref can be used. Also, now that reusable stuff is contained in the `components` object it should be more clear about what...

That is how I understand it, other than one really weird exception that I just realized when reading your fourth point. I have envisioned that $ref should only be used...

I don't understand why inventing a new OpenAPI property that does the same thing as defining the Accept-Encoding header is useful. What do you see as "complex and difficult" about...

@cyberphone As I understand it, this issue is related to a reserved property name within an object that is a JWT. As such, I don't think either option you describe...

@cyberphone @pleothaud I appreciate your explanations above, I am now in a much better place to have this conversation. Here's my perspective on this. OpenAPI is a description of an...