clean up Ray class code & docs
document edge cases a bit clearer
clean up str/repr for functions
correct sphinx function argument name typesetting