enhance README.md, refactor globals