* fix README.md markdown
* update conventions