better readme doc -- closing issue #2 for now