#16: add docs for helpers