Skip to content

Make route summary optional #667

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 17, 2018
Merged

Make route summary optional #667

merged 2 commits into from
Mar 17, 2018

Conversation

owenbendavies
Copy link

Resolves #661

Currently if no summary is provided, grape-swagger uses the description.
This creates needless duplicate fields. As summary is an optional field
this changes functionality so summary is only populated if specifically
needed.

Reference https://swagger.io/specification/

@grape-bot
Copy link

grape-bot commented Feb 24, 2018

1 Error
🚫 One of the lines below found in CHANGELOG.md doesn’t match the expected format. Please make it look like the other lines, pay attention to periods and spaces.
* [#667](https://github.com/ruby-grape/grape-swagger/pull/667):  Make route summary optional - [@obduk](https://github.com/obduk).

Generated by 🚫 danger

@coveralls
Copy link

coveralls commented Feb 24, 2018

Coverage Status

Coverage remained the same at 97.248% when pulling b22cebe on obduk:optional-summary into 6e564a1 on ruby-grape:master.

Resolves #661

Currently if no summary is provided, grape-swagger uses the description.
This creates needless duplicate fields. As summary is an optional field
this changes functionality so summary is only populated if specifically
needed.

Reference https://swagger.io/specification/
@ruby-grape ruby-grape deleted a comment from coveralls Mar 17, 2018
@ruby-grape ruby-grape deleted a comment from coveralls Mar 17, 2018
@ruby-grape ruby-grape deleted a comment from coveralls Mar 17, 2018
@ruby-grape ruby-grape deleted a comment from coveralls Mar 17, 2018
@LeFnord
Copy link
Member

LeFnord commented Mar 17, 2018

thanks @obduk … it would be nice, to have some specs with summary, to document the behaviour,
that it can be explitely set, such as the PR name suggest

@owenbendavies
Copy link
Author

@LeFnord thanks for looking at this. There are already tests for this in spec/swagger_v2/namespaced_api_spec.rb as it is not new functionality.

@LeFnord
Copy link
Member

LeFnord commented Mar 17, 2018

ok, then I'm fine with it and mörge it, thanks again

@LeFnord LeFnord merged commit 3057a2c into ruby-grape:master Mar 17, 2018
@owenbendavies owenbendavies deleted the optional-summary branch March 17, 2018 13:53
LeFnord pushed a commit to LeFnord/grape-swagger that referenced this pull request Feb 9, 2019
Resolves ruby-grape#661

Currently if no summary is provided, grape-swagger uses the description.
This creates needless duplicate fields. As summary is an optional field
this changes functionality so summary is only populated if specifically
needed.

Reference https://swagger.io/specification/
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants