clarifying isValid docs
fixing merge