fixes #521 helper fns in public docs [ci skip]