rabbitmq-website
rabbitmq-website copied to clipboard
Very experienced engineer experiencing issues getting started with RabbitMQ
Is your feature request related to a problem? Please describe.
Context This is a a few months old but an interesting stream nonetheless: A very experienced engineer (ex-Meta, ex-PHP core team, author of Wezterm - a terminal emulator some of us use) but with zero RabbitMQ experience attempts to get started with RabbitMQ. The first 30 minutes or so give an idea of what an outsider runs into. Engineer uses DuckDuckGo, so perhaps the engineer's search results are different than what most people would get but:
Path taken by the engineer
- quickly ends up on https://rabbitmq.com/how.html, a page I didn't even know existed, basically unmaintained
- from that page, goes to a presentation by Alexis from 2009...
- I believe he is looking for a CLI to send a message (which exists but he can't find it)
- engineer then starts RabbitMQ in a container and tries to connect
rabbitmq-diagnostics
from the engineer's own machine, tries to guess how to specify the remote node (-n); at some point gives up and starts RabbitMQ directly on engineer's own machine - Found docs and
rabbitmqctl
help output difficult to navigate - Finally finds the tutorials, I guess expects a Rust tutorial but that is not available in RabbitMQ docs
- once engineer starts playing with the Python tutorial, everything seems to click
Describe the solution you'd like
See slack conversation for the possible solutions suggested: https://vmware.slack.com/archives/C015KF6KMU2/p1689071908543589
Subsequent conversation between @mkuratczyk and @pstack2021 on possible solutions for this: https://vmware.slack.com/archives/D03B3J54TN1/p1689087012852929
Next steps @mkuratczyk To put something together for discussion and we can take it from there.
Describe alternatives you've considered
No response
Additional context
No response