nats-io / nats-architecture-and-design

Architecture and Design Docs
Apache License 2.0
187 stars 20 forks source link

Nats Concepts section needs it's own tutorial #39

Closed jnmoyne closed 2 years ago

jnmoyne commented 2 years ago

Overview

Right now nats-concepts->publish-subscribe has a link to “the pub-sub tutorial” (inside the ‘developing with nats’ section and which means the doc reader must compile and run the Go client examples and use those examples just to do very simple stuff like publish or listen, request/reply, etc...).

The problem is that IMHO many of the people reading the docs, and specifically the concepts, are not necessarily going to be developers or have Golang installed on their machine, while at the same time it is very easy to demonstrate most of those concepts just using the 'nats' cli tool. So you could easily create a walkthrough for people to very quickly play with nats by having them just install 'nats-server' and 'nats' and then just type run nats-server locally on their machine with the default settings (or just with -js) and then go through a walkthrough/tutorial and actually play with nats by themselves. This walkthrough could also be recorded as a video and posted to our YouTube channel (and the doc would have a link to that video).

Tasks