chore: refactor api docs

[darrenvechain]

These changes include

• Updates to Open API Spec
  • Update examples to return actual results
  • Add error codes for each endpoints
  • Update & expand on descriptions
  • Fixing typos
  • Remove deprecated endpoints from spec
  • Deprecate /subscriptions/beat
• Migration from swagger UI to Stoplight elements
  • UI is also modified such that examples are not shown for websocket endpoints

Changes tested by visiting this URL

• https://darrenvechain.github.io/thor-docs

[darrenvechain]

Hey @libotony I've made the updates you suggested

[darrenvechain]

Hey @libotony I resolved your latest comments in the latest commit

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (39ecf84) 57.40% compared to head (36494aa) 51.98%.
Report is 3 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #628      +/-   ##
==========================================
- Coverage   57.40%   51.98%   -5.43%     
==========================================
  Files         179      156      -23     
  Lines       20678    17218    -3460     
==========================================
- Hits        11870     8950    -2920     
+ Misses       7922     7445     -477     
+ Partials      886      823      -63     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[darrenvechain]

Apologies @libotony, I missed those. I have pushed the changes now

[claytonneal]

hi @darrenvechain for request:
/debug/storage-range
its not clear to me what the parameter "target" means - perhaps could do with an extra explanation? thanks

[darrenvechain]

hi @darrenvechain for request: /debug/storage-range its not clear to me what the parameter "target" means - perhaps could do with an extra explanation? thanks

@claytonneal I made the changes:

63a9b32...darrenvechain:thor:api-doc-refactor

[libotony]

How about using this as the screenshot? The older one has a small shadow around the page that will show the frame of the image.