Follow-up from #987 for grape-swagger 2.3. Not blocked on Grape.
default: is ignored
The README "Default response" section documents desc ..., default: { ... }. The code has only ever read default_response:. The documented spelling silently produces no default response.
Grape's route.default cannot be the fallback: on released Grape it is OrderedOptions#default, i.e. Hash#default, so it is nil even when the :default key is set. Dual-support without going back to route.options is:
route.try(:default_response) || route.settings.dig(:description, :default)
try is nil when respond_to? is false, so this still works if Grape drops delegate_missing_to before a real default_response reader exists. settings is a real reader.
default_response: stays the preferred spelling. default: remains until grape-swagger 3.0. Grape HEAD already remaps default: onto default_response (ruby-grape/grape#2862); grape-swagger 3.0 can then read default_response only.
Stop reading route.desc
desc 'text' stores :description. route.desc is almost never set and is not a Grape reader. Drop summary = route.desc if route.desc in summary_object. Keep route.description, route.detail, and route.summary. No Grape reader for desc.
Out of scope
success / failure fallbacks stay until 3.0. No grape-swagger issue for adding a desc reader.
Follow-up from #987 for grape-swagger 2.3. Not blocked on Grape.
default:is ignoredThe README "Default response" section documents
desc ..., default: { ... }. The code has only ever readdefault_response:. The documented spelling silently produces nodefaultresponse.Grape's
route.defaultcannot be the fallback: on released Grape it isOrderedOptions#default, i.e.Hash#default, so it isnileven when the:defaultkey is set. Dual-support without going back toroute.optionsis:tryis nil whenrespond_to?is false, so this still works if Grape dropsdelegate_missing_tobefore a realdefault_responsereader exists.settingsis a real reader.default_response:stays the preferred spelling.default:remains until grape-swagger 3.0. Grape HEAD already remapsdefault:ontodefault_response(ruby-grape/grape#2862); grape-swagger 3.0 can then readdefault_responseonly.Stop reading
route.descdesc 'text'stores:description.route.descis almost never set and is not a Grape reader. Dropsummary = route.desc if route.descinsummary_object. Keeproute.description,route.detail, androute.summary. No Grape reader fordesc.Out of scope
success/failurefallbacks stay until 3.0. No grape-swagger issue for adding adescreader.