refactored, added notes in README