readme and tweaks in helper