Moving forward I have no reasons to believe we cannot extend our CI scripts with the help of @domenkozar to also push the updated link into this JS so that every time we deploy a new version of Cardano, the docs remains nice and consistent, and above all they are simply a remote, inspectable resource (I want in the future to commit the swagger.json in full into cardano-sl, so that we can retrieve the precise snapshot of the API at each SHA commit).
Hey @denisshevchenko ,
this consolidates our conversation about rendering the wallet API to use the official swagger-ui package.
This is a sneak-peak on what we generate now for the wallet:
And we can easily extend this to explorer when the time will come. Note how this PR is far from perfect:
css
andjs
; I know too little about Jekyll to fix this properly 😁Moving forward I have no reasons to believe we cannot extend our CI scripts with the help of @domenkozar to also push the updated link into this JS so that every time we deploy a new version of Cardano, the docs remains nice and consistent, and above all they are simply a remote, inspectable resource (I want in the future to commit the
swagger.json
in full intocardano-sl
, so that we can retrieve the precise snapshot of the API at each SHA commit).Let me know if this is a good step forward!