added notes re: idempotency