Add doc clarifications

Added some clarifications to points that got me confused before.

Also renamed `Recv() (event interface{} ..` to `Recv() (stanza interface{} ..` to use correct term.