Trying to live up the Django docs is a big challenge given that Django was started by folks at a big newspaper. I think clear documentation is a core value to that project.
I agree that the automatic Hex docs are often a little sparse - they often just document the library API and don't give examples.
If you are trying to port websocket code to Elixir/Phoenix I'd recommend the "Real-Time Phoenix" book ( https://pragprog.com/titles/sbsockets/real-time-phoenix/). It has some hard won knowledge in it (I don't know the author, I just enjoyed the book).