4.2.7

Changed

• Component schemas are now sorted alphabetically in compiled OpenAPI specifications. #184

4.2.6

Added

• Added x-mill-path-aliased and x-mill-path-aliases extensions to compiled OpenAPI specs. #183

4.2.5

Fixed

• Removed some bad TagReducer unit tests. d7c2c2c

4.2.4

Fixed

• Loose tag reductions through the TagReducer are no longer case-sensitive. #182

4.2.3

Added

• Allowing OpenAPI specs to be reduced, with the TagReducer, with looser tag names. #181

4.2.2

Fixed

• Paths in compiled OpenAPI specification are now in alphabetical order. #180

4.2.1

Changed

• Loosened the symfony/yaml requirements to allow ^2.0|^3.0|^4.0 instead of only ^2.0. #179

4.2.0

Added

• Adding x-mill-path-template for outputting the raw path template to the specification. Can be helpful if you want to utilize RFC 6570 templates in your specification usage. #177
• A new environment attribute on server config entries. #177
• New --environment flag on ./bin/mill compile that lets you compile OpenAPI specifications for specifically configured server environments. #177

Changed

• Renaming x-mill-deprecated to deprecated. #177
• Renaming x-mill-vendortags to x-mill-vendor-tags. #177

4.1.0

Added

• A new @api-operationid annotation for setting unique operation IDs on resource actions. #174
• OpenAPI compilation now generates individual specifications for each tag (@api-group). #176

Fixed

• Max/min version annotations now properly support Semver patch versions during compilation. #176

4.0.0

Added

• OpenAPI compilation support. #16
• A new @api-vendortag annotation, replacing @api-capability. #148
• @api-maxversion. Same as @api-minversion, but the opposite. #161
• Added additional relevant data to request parameters in JSON-generated changelogs. #107
• Support for subtypes to @api-param. #159
• A new @api-queryparam annotation for documenting parameters that are to be used in query strings. @api-param now represents body payloads. #109
• New configurations: authentication, info and servers #173

Changed

• The generate command is now called compile. #16
• Renamed @api-throws to @api-error. #141
• @api-error annotations now have a new MSON syntax. #155
• @api-uri is now @api-path. #162
• @api-urisegment is now @api-pathparam. #162
• The scopes config is now nested within authentication. #173
• The generators config is now called compilers. #16

Fixed

• Now throwing an exception when enum annotations (annotations with member values) are written as string. #150
• Subtypes are now being properly converted to API Blueprint-compatible types during API Blueprint compilation. #147
• Scopes are now passed down through @api-see annotations, much like @api-version is already. #140
• Multi-line enum descriptions are now supported. #160
• Non-aliased paths can no longer be selected as the primary path for a resource action. #139

Removed

• @api-capability has been removed and replaced with a new @api-vendorTag system. #148