Seems a shame to have such excellent documentation but to leave the param/return annotations out. I'd just copy the very first sentence for the return.