rabbitmq-website icon indicating copy to clipboard operation
rabbitmq-website copied to clipboard

Very experienced engineer experiencing issues getting started with RabbitMQ

Open pstack2021 opened this issue 1 year ago • 2 comments

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

  1. quickly ends up on https://rabbitmq.com/how.html, a page I didn't even know existed, basically unmaintained
  2. from that page, goes to a presentation by Alexis from 2009...
  3. I believe he is looking for a CLI to send a message (which exists but he can't find it)
  4. 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
  5. Found docs and rabbitmqctl help output difficult to navigate
  6. Finally finds the tutorials, I guess expects a Rust tutorial but that is not available in RabbitMQ docs
  7. 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

pstack2021 avatar Jul 17 '23 10:07 pstack2021