search

shamirlabs / diva-alpha-net

Diva alpha testnet
https://docs.shamirlabs.org/diva/testnet/intro
19 stars 17 forks source link

Bearer Swagger key #65

Closed micho closed 10 months ago

micho commented 1 year ago

I spoke to a user who didn't know the bearer key would later be used for Swagger. Can we make this more clear during the installation process?

FUINY7 commented 1 year ago

I think it's more peoples that have ZERO knowledge (like me) and didn't even know what a "bearer" was and that we should write "bearer" before the API_Key.

micho commented 1 year ago

@pradavc im happy to suggest copy for this if you help me understand how it will be used! i was also super confused

NikoETHVida commented 10 months ago

Several users have ran into the same issue (including me). Maybe we can include this note (together with others) into a V2.0 of the "Register your node" video.

micho commented 10 months ago

I found that the video does indeed show Swagger (see below) and that's confusing

where else does it appear in the first time user experience? @pradavc suggested moving it to an "advanced usage" section

telegram-cloud-photo-size-4-5935895801417022747-y

pradavc commented 10 months ago

I separated the sections into 2 parts, the Swagger section as optional to make it clear. We will introduce changes to the UI as well to make it clear that it is an API for development.

Closing this issue with https://github.com/shamirlabs/docs/pull/35