Documentation of Consume and NotifyConfirm buffers

Also update the examples to ensure buffered chans are used for
NotifyConfirm so not to produce a deadlock when issuing another RPC call
on the Connection from a blocked NotifyConfirm receiver.