-
-
Notifications
You must be signed in to change notification settings - Fork 540
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[New Doc 📑]: create EDA architecture diagram for Docs Overview page #518
Comments
Hey @alequetzalli , I like the idea 💯 What kind of diagram would you be looking for? EDA diagram with links to AsyncAPI on it, or just a general EDA diagram for now? I assumed maybe Or maybe even a couple?
Think either way it needs to be simple to understand, nothing to busy/confusing. Don't wanna scare people away 😅 |
@boyney123 that's a great idea to have a "before AsyncAPI" diagram that explains EDAs in general and then to have a second diagram that is a "using AsyncAPI" visual on how the spec fits into that process 🎉 I think that could possibly squash a lot of the initial confusion of what AsyncAPI is and why it is better to use the spec in your EDA process. (This is just what I have digested over the past couple months of learning AsyncAPI, so correct me if I am wrong in my explanation 😄 ) What do you think @alequetzalli?? Would also love to get some feedback from more contributors anyways before we make a decision, but I think this is a great first bit of feedback 🙌 |
@mcturco @boyney123 Thank you dave for starting off the convo!! I really like your ideas and I feel like you really got it. I completely agree with you that it should be basic and not scare people away 🤣 Missy, I like the idea of showing what it's like to apply asyncAPI... tbh, I feel less confident in this area so I am hoping to hear more opinions and learn what others think about it. 🙃✌🏽 Question, I notice we seem to be talking about having to diagrams… Are you thinking about adding two diagrams to the overview page or how do you think it could be useful? 🤔 |
@alequetzalli Absolutely!! So I think we can get clever with the "2 diagrams" thing and it could maybe be a GIF animation or SVG animation if we make the visuals simple enough So we can keep the diagram all in one space! But definitely would love to hear what others think first |
@mcturco Ooooh, an animated diagram! Daaaamn, that sounds both fancy and useful! I want to upvote this idea |
Showing the two diagrams in one space gave me the idea of doing this: https://codesandbox.io/s/react-image-comparison-evpeu. |
Copying this from slack so it can stay in our discussion :) from: @boyney123 |
I love this! |
/gfi docs |
This issue has been automatically marked as stale because it has not had recent activity 😴 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 ❤️ |
This issue has been automatically marked as stale because it has not had recent activity 😴 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 ❤️ |
What Dev Docs changes are you proposing?
As part of the work towards the Docs issue of designing a NEW Docs /Overview landing page, we would like to include an EDA architecture diagram above the fold. (This proposal originally came from #503.)
While @mcturco has been amazing enough to confirm excitement in this proposal and in contributing towards the
design
part, we both agree we need a deeper engineering perspective from the broader community to determine what that diagram should include.Tagging some more contributors we'd love to hear from for this: @fmvilas @smoya @derberg @jonaslagoni @boyney123
Code of Conduct
The text was updated successfully, but these errors were encountered: