improve readme.md and helpers