update documentation and added missing helpers