RapiDoc icon indicating copy to clipboard operation
RapiDoc copied to clipboard

Security Schema Template Displays a Fixed Description in Security Schemas

Open a-chacon opened this issue 10 months ago • 0 comments

Hi! I noticed that RapiDoc is showing a general description for any of the security schemas available after the OAS description. Specifically, this line in the code: https://github.com/rapi-doc/RapiDoc/blob/7f53d25959e5a4e1beb4b610aaef445b896838f2/src/templates/security-scheme-template.js#L493

If my OAS already provides a description for the security schema, having this redundant general description displayed afterward creates confusion about how to use the security schema.

My expected behavior is that the general description should not be shown if the OAS already contains a description for the security schema. This redundancy can lead to confusion, as seen in this issue: https://github.com/a-chacon/oas_rails/issues/91.

a-chacon avatar Apr 02 '25 19:04 a-chacon