Skip to content

Fixes for OpenAPI (RPC) documents and QA docs restructuring#472

Merged
andynog merged 8 commits intomainfrom
andy/qa-rpc-docs-fix
Mar 20, 2023
Merged

Fixes for OpenAPI (RPC) documents and QA docs restructuring#472
andynog merged 8 commits intomainfrom
andy/qa-rpc-docs-fix

Conversation

@andynog
Copy link
Collaborator

@andynog andynog commented Mar 6, 2023

This PR fixes:

  • Outaded and wrong information on OpenAPI documentation (RPC)

    • Added information about CORS
    • Replace old ws websocket client (not updated anymore) with websocat (maintained)
    • Replace old rpc endpoint with one from the Cosmos registry
    • Remove all http endpoints information about websockets subscription (e.g. /subscribe)
  • Refactor the structure of the QA documents (/docs/qa) in order to properly display in the navigation (see below):

image

@andynog andynog added bug Something isn't working documentation Improvements or additions to documentation backport-to-v0.34.x labels Mar 6, 2023
@andynog andynog requested a review from a team as a code owner March 6, 2023 16:38
@andynog andynog self-assigned this Mar 6, 2023
@andynog andynog requested review from a team and thanethomson March 17, 2023 15:12
Copy link
Contributor

@thanethomson thanethomson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM, just a couple of minor things to address before merging.

andynog and others added 5 commits March 20, 2023 17:13
Co-authored-by: Thane Thomson <connect@thanethomson.com>
Co-authored-by: Thane Thomson <connect@thanethomson.com>
Co-authored-by: Thane Thomson <connect@thanethomson.com>
@andynog andynog merged commit 3cd1037 into main Mar 20, 2023
@andynog andynog deleted the andy/qa-rpc-docs-fix branch March 20, 2023 21:32
mergify bot pushed a commit that referenced this pull request Mar 20, 2023
* openapi doc fixes and QA docs fixes

* rename title

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* fix text

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* add backquotes

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* update contact

---------

Co-authored-by: Thane Thomson <connect@thanethomson.com>
(cherry picked from commit 3cd1037)

# Conflicts:
#	rpc/openapi/openapi.yaml
mergify bot pushed a commit that referenced this pull request Mar 20, 2023
* openapi doc fixes and QA docs fixes

* rename title

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* fix text

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* add backquotes

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* update contact

---------

Co-authored-by: Thane Thomson <connect@thanethomson.com>
(cherry picked from commit 3cd1037)

# Conflicts:
#	docs/qa/CometBFT-QA-37.md
#	docs/qa/README.md
#	docs/qa/TMCore-QA-37.md
#	docs/qa/img37/200nodes_cmt037/all_experiments.png
#	docs/qa/img37/200nodes_cmt037/avg_mempool_size.png
#	docs/qa/img37/200nodes_cmt037/block_rate.png
#	docs/qa/img37/200nodes_cmt037/cpu.png
#	docs/qa/img37/200nodes_cmt037/e_75cb89a8-f876-4698-82f3-8aaab0b361af.png
#	docs/qa/img37/200nodes_cmt037/memory.png
#	docs/qa/img37/200nodes_cmt037/mempool_size.png
#	docs/qa/img37/200nodes_cmt037/peers.png
#	docs/qa/img37/200nodes_cmt037/rounds.png
#	docs/qa/img37/200nodes_cmt037/total_txs_rate.png
#	docs/qa/img37/200nodes_tm037/avg_mempool_size.png
#	docs/qa/img37/200nodes_tm037/block_rate_regular.png
#	docs/qa/img37/200nodes_tm037/cpu.png
#	docs/qa/img37/200nodes_tm037/memory.png
#	docs/qa/img37/200nodes_tm037/mempool_size.png
#	docs/qa/img37/200nodes_tm037/peers.png
#	docs/qa/img37/200nodes_tm037/rounds.png
#	docs/qa/img37/200nodes_tm037/total_txs_rate_regular.png
#	docs/qa/img37/200nodes_tm037/v037_200node_latencies.png
#	docs/qa/img37/200nodes_tm037/v037_latency_throughput.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_heights.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_load1.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_mempool_size.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_mempool_size_avg.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_peers.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_rounds.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_rss.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_rss_avg.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_total-txs.png
#	docs/qa/img37/200nodes_tm037/v037_report_tabbed.txt
#	docs/qa/img37/200nodes_tm037/v037_rotating_heights.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_heights_ephe.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_latencies.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_load1.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_peers.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_rss_avg.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_total-txs.png
#	rpc/openapi/openapi.yaml
andynog added a commit that referenced this pull request Mar 21, 2023
…472) (#561)

* Fixes for OpenAPI (RPC) documents and QA docs restructuring (#472)

* openapi doc fixes and QA docs fixes

* rename title

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* fix text

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* add backquotes

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* update contact

---------

Co-authored-by: Thane Thomson <connect@thanethomson.com>
(cherry picked from commit 3cd1037)

# Conflicts:
#	docs/qa/CometBFT-QA-37.md
#	docs/qa/README.md
#	docs/qa/TMCore-QA-37.md
#	docs/qa/img37/200nodes_cmt037/all_experiments.png
#	docs/qa/img37/200nodes_cmt037/avg_mempool_size.png
#	docs/qa/img37/200nodes_cmt037/block_rate.png
#	docs/qa/img37/200nodes_cmt037/cpu.png
#	docs/qa/img37/200nodes_cmt037/e_75cb89a8-f876-4698-82f3-8aaab0b361af.png
#	docs/qa/img37/200nodes_cmt037/memory.png
#	docs/qa/img37/200nodes_cmt037/mempool_size.png
#	docs/qa/img37/200nodes_cmt037/peers.png
#	docs/qa/img37/200nodes_cmt037/rounds.png
#	docs/qa/img37/200nodes_cmt037/total_txs_rate.png
#	docs/qa/img37/200nodes_tm037/avg_mempool_size.png
#	docs/qa/img37/200nodes_tm037/block_rate_regular.png
#	docs/qa/img37/200nodes_tm037/cpu.png
#	docs/qa/img37/200nodes_tm037/memory.png
#	docs/qa/img37/200nodes_tm037/mempool_size.png
#	docs/qa/img37/200nodes_tm037/peers.png
#	docs/qa/img37/200nodes_tm037/rounds.png
#	docs/qa/img37/200nodes_tm037/total_txs_rate_regular.png
#	docs/qa/img37/200nodes_tm037/v037_200node_latencies.png
#	docs/qa/img37/200nodes_tm037/v037_latency_throughput.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_heights.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_load1.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_mempool_size.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_mempool_size_avg.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_peers.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_rounds.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_rss.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_rss_avg.png
#	docs/qa/img37/200nodes_tm037/v037_r200c2_total-txs.png
#	docs/qa/img37/200nodes_tm037/v037_report_tabbed.txt
#	docs/qa/img37/200nodes_tm037/v037_rotating_heights.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_heights_ephe.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_latencies.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_load1.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_peers.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_rss_avg.png
#	docs/qa/img37/200nodes_tm037/v037_rotating_total-txs.png
#	rpc/openapi/openapi.yaml

* mergify conflic fixes for v0.34 (#561)

---------

Co-authored-by: Andy Nogueira <me@andynogueira.dev>
andynog added a commit that referenced this pull request Mar 21, 2023
…472) (#560)

* Fixes for OpenAPI (RPC) documents and QA docs restructuring (#472)

* openapi doc fixes and QA docs fixes

* rename title

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* fix text

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* add backquotes

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* update contact

---------

Co-authored-by: Thane Thomson <connect@thanethomson.com>
(cherry picked from commit 3cd1037)

# Conflicts:
#	rpc/openapi/openapi.yaml

* fixing mergify conflicts (#560)

---------

Co-authored-by: Andy Nogueira <me@andynogueira.dev>
roy-dydx pushed a commit to dydxprotocol/cometbft that referenced this pull request Jul 11, 2023
…ometbft#472) (cometbft#560)

* Fixes for OpenAPI (RPC) documents and QA docs restructuring (cometbft#472)

* openapi doc fixes and QA docs fixes

* rename title

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* fix text

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* add backquotes

Co-authored-by: Thane Thomson <connect@thanethomson.com>

* update contact

---------

Co-authored-by: Thane Thomson <connect@thanethomson.com>
(cherry picked from commit 3cd1037)

# Conflicts:
#	rpc/openapi/openapi.yaml

* fixing mergify conflicts (cometbft#560)

---------

Co-authored-by: Andy Nogueira <me@andynogueira.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation

Projects

No open projects
Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants