add api comments for IInvalidatable