doc: add some internal docs for watch/notify

Signed-off-by: Samuel Just <sam.just@inktank.com>