first pass at updating README. see ./docs/helpers.md