Swagger 2.X Migration from 1.5

This guide is going to contain various points of consideration when migration from swagger-core 1.5 to swagger-core 2.X. While it may be confusing, keep the following in mind:

• swagger-core 1.5 produces Swagger/OpenAPI 2.0 definitions.
• swagger-core 2.X produces OpenAPI 3.0 definitions.

Swagger-core 2.0 is a major release, with breaking changes in all areas, including swagger annotations.

Over the next few weeks we’ll add pointers to help with the move.