update documentation on transactional operations