more improvements to readme, helper formatting