Consolidate the JSON and YAML examples in the specs into one codeblock to reduce the readers scroll effort
Opened this issue · 2 comments
Description:
Currently, the examples in the specs are shown in two variants (JSON and YAML) and displayed vertically one below the other. This increases the scrolling effort of the readers.
Reproduce by navigating to https://www.asyncapi.com/docs/reference/specification/v3.0.0#specification
Proposal:
To reduce this effort, I propose to combine the examples in a single block each and let the readers decide to choose between JSON or YAML by building tabs right above the example code block.
Screenshots: Change highlighted in red
Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.
I also feel same. This issue is website related right? So, we need to make changes in asyncapi/website repository, right?