Open sanscontext opened 1 year ago
Screenshots of before and after would be appreciate @sanscontext :)
cc @mrin9
Thanks @AdrianMachado , I added some before/after screenshots, trying to limit it to just what I've touched in this PR.
I was thinking about the bearerFormat
part, and I'd actually want to see some examples of how it's used in the wild before assuming it'd be helpful here. The OAS isn't very prescriptive on how this should be used, and "Hint" isn't going to mean the same thing to everyone. Would this be something we could poll the Discord for, for examples?
✔️ Adds a link to the #auth anchor on the "no api key set" message, so that readers get a CTA how to fix it. After: (I don't have a non-edited version to screenshot for a Before)
This may not be the case always. An user can always hide the auth section, in that case the link wont take it to anywhere
Thanks all, I'm open to additions to this PR. As I mentioned to @AdrianMachado, I'm not a developer so my changes here are rudimentary but high-impact on our end. It'd be nice not to have to add them to every new version of Rapidoc I pull down.
I can take a look later this week
Hey folks, it's been six months. Should I just close this?
Hey folks, is there any way to get this looked at please?
This PR:
✔️ Adds a link to the
#auth
anchor on the "no api key set" message, so that readers get a CTA how to fix it. After: (I don't have a non-edited version to screenshot for a Before)✔️ Renders the
bearerFormat
string as the field hint text, for HTTP Bearer type auth, if one is set. (If not set, uses the originalapi-token
.) Before: After:✔️ Similarly, renders the
bearerFormat
string as the noun in the instructional text, if set. (If not set, uses the original "Token String".) Before: After:⚠️ Attempts to check if there are >1 of a type of security scheme, and add the
${v.securitySchemeId}
if there are, except I couldn't get this working or troubleshoot effectively with my rudimentary JS skills. Not working right now, but when it's done it would look something like this: Before: two different auth formats with the same name, so you have to use the descriptive text to tell them apart. After: much easier to see that these are differentThanks all!