changed swagger version to 1.2 (from 1.1)
The resource listing no longer requires a basePath.
Each operation element can contain an optional responseMessages value. This was renamed from errorResponses.
The parameters has been updated to support JSON-schema v4 format. format property is used for more fine grained type declaration
Each element in the responseMessages array contains an integer code and string message field. Previously, the analogous errorResponse attributes were named code and reason respectively.
The dataType field has been renamed to type for consistency with the JSON-schema v4 draft spec.
The allowableValues field has been absorbed into an enum for LIST type, and minimum + maximum for ranges
The API Declaration supports a `produces` array and `consumes` array, which are array of strings. These apply to all operations in the API unless overridden at the API level
Elements in the operations array can contain `produces`, this value overrides any existing values at the API Declaration
Bringing back the baseUrl as suggested in #191