Very experienced engineer experiencing issues getting started with RabbitMQ

[pstack2021]

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

[michaelklishin]

We have removed that page and made it redirect to the tutorials.

[pstack2021]

Actions:

• @mkuratczyk to create a "getting started" video (video would include brief overview of what RabbitMQ is -> without writing any programs, you can use the Management UI to: declare a queue/exchange/binding/ -> send messages - consume messages) user would now understand the basic concepts of RabbitMQ...Next explain, while you can do all these through the Management UI, you can also (if a developer) complete these tasks using code.)
• @pstack2021 will review, we will have a few iterations of this to get it right
• Final approved iteration will hopefully be hosted to youTube and we can then include a link to this video on the OSS RMQ Getting started: https://www.rabbitmq.com/#getstarted docs

No deadlines on this task right now @mkuratczyk and @pstack2021 busy with other work commitments and have upcoming PTO