Swagger Jsdoc Versions Save

Handle empty annotations cases https://github.com/Surnet/swagger-jsdoc/pull/229

Contains first version of a major rewrite and first iteration of handling yaml references with anchors and aliases between separate comments.

⚠️Patch containing breaking changes!!!⚠️

Unfortunately, the automated publishing script wrongly published this patch instead of v5 https://github.com/Surnet/swagger-jsdoc/releases/tag/v5.0.0

Please ignore this update and bump to major or do stay at 4.3.1 until updating your tags as mentioned in https://github.com/Surnet/swagger-jsdoc/pull/220

Reorganizing code by modules related to their purpose, which makes the specification-related utils easier to manage in 1 place. Other helpers have also been reorganized into combined modules, which makes it easier to mock selected functions within modules.

BREAKING CHANGES

• The support for deprecated properties has been removed. Please use the plural form. This support for deprecated properties has lasted for 4 years.
• Upgraded to Erbium (LTS)

It's now possible to include your .coffee files into the result swagger specification.

Example:

swagger-jsdoc.js -d example/v2/swaggerDef.js example/v2/route.coffee

• It's now possible to annotate code with @openapi instead of @swagger #200
• improved error messages for inputs #208

Upgrade dependencies to solve security vulnerabilities.

Node version 8 aka Carbon is no longer supported. Please refer to this information regarding release. Version 3 of swagger-jsdoc is still available at branch v3, but will not be maintained any more.

Please use Node version 10 aka Dubnium or higher.

No changes compared to 3.6.0 except downgrades in dependencies to ensure proper work with Node carbon, i..e LTS of version 8. Thus, this will be the last release with support for Node version 8.

Upgrade dependencies.