Mlbileschi update partial function documentation

To include the fact that the caller is responsible for checking 'isDefinedAt', except when using partial functions defined using {} and case statements.
I would call it "nonsensical" rather than "insane", since the value does not make sense but also does not suffer from a psychiatric disorder.