new helpers version with doc and code tweaks