refactored helpers, improved readme