ij review: improve documentation

* use-cases
* gotchas
* channel registry
* xenstore protocol

Signed-off-by: David Scott <dave.scott@citrix.com>