Update doc specifically:

  - attempt to separate implementation from interface guarantees
  - switch to feature bits from version numbers
  - be explicit about who writes to what, when
  - relate reconnection to the RESET_WATCHES command in the higher layer

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