better flow for readme.md