Improve docs, raise ValueError instead of return.