adding documentation for partial functions