Thanks for your blog. ;)
I would like to request something, though.
A thing that I saw in the OAI site (https://github.com/OAI/OpenAPI-Specification/blob/main/examples/v3.0/petstore-expanded.yaml#L138) and I can’t find an explanation anywhere is the use of two Schemas Pet and NewPet. It seems that it is a solution to deal with a required id on post and put. Perhaps you could write a post about this practice ?