[📑 Docs]: Tutorials | Getting Started | Coming from OpenAPI | Interactive Comparison

[vinodpahuja]

What Dev Docs changes are you proposing?

I came from OpenAPI looking for a similar thing to document my JMS/AMQP bases applications. I found this comparison quite useful. Also I was curious to know how it would be like if we apply some interaction to it. Meaning, what if we can change this https://asyncapitools.github.io/OA2AA/OA2AA.html to something like this https://asyncapitools.github.io/OA2AA/iOA2AA.html ( hover to see action )

Please share your feedbacks.

Code of Conduct

• [X] I agree to follow this project's Code of Conduct

[derberg]

@vinodpahuja that looks pretty nifty. You mean you would like to plug it into asyncapi docs?

I always dreamed to have something like http://openapi-map.apihandyman.io/ for AsyncAPI. We even had some interest but no further implementation -> https://github.com/asyncapi/community/discussions/55. Generating it from JSON Schema should not be that hard, more complicated would be design itself I think, and updating our JSON Schema with descriptions that are already in the spec

[vinodpahuja]

@derberg good to know the effort in this direction. yes, I would love to see in live in docs. and yes, it would be great to generate it dynamically from json schema. For me ( being a java developer), I have just tried to add little spice to plain markup taken from coming-from-openapi. Looking at source, I have no idea on how it would be done in react/next.js. Can someone please help here ?

[AceTheCreator]

@vinodpahuja I'd love to collaborate and help you with this. What do you think?

[vinodpahuja]

@vinodpahuja I'd love to collaborate and help you with this. What do you think?

Sure @AceTheCreator , Please try ro merge the above js into react component and share the output Thanks

[nawed2611]

Can I work on this issue?

[vinodpahuja]

Can I work on this issue?

Sure @nawed2611

[github-actions[bot]]

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart: