documented the helpers