Swagger 2.0 to OpenAPI 3.x migration: a field-tested checklist
Automatic converters handle the mechanical 80 percent and quietly break the other 20: nullable fields, consumes/produces, body parameters, security definitions, and examples. Here is the migration checklist that actually gets a 2.0 spec to 3.2 without lying to consumers.