Goa v3.29.1

Goa v3.29.1 fixes OpenAPI documents that contain header or cookie parameters. Generated OpenAPI now emits allowEmptyValue only where the specification permits it: query parameters.

Fix

• Stop emitting allowEmptyValue for header and cookie parameters in OpenAPI 3.0 and 3.2 output. Strict OpenAPI validators now accept these parameter objects. Query parameter behavior is unchanged. (#3954)
• Add regression coverage for every parameter location and for distinct primitive alias components and descriptions.

Upgrade

Upgrade and regenerate your OpenAPI documents as usual:

go get goa.design/goa/v3@v3.29.1
goa gen your/design/package

Services whose generated specifications contain headers or cookies should see the invalid allowEmptyValue fields disappear.

Maintenance

• Document the repository-defined release workflow for future Goa releases. (#3955)
• Regenerate and test the Goa examples and plugins repositories against v3.29.1.

Contributors

Thank you to Raphael Simon for this release.

Links

• Full commit comparison
• OpenAPI parameter fix