File uploads in OpenAPI: multipart/form-data, raw binary, and multiple files done right

File upload is the endpoint most teams hand-wave in an OpenAPI document. The request works in the one client they tested, so nobody notices that the spec says type: string, omits the multipart encodin