better readme and a few helper attribs