removed unnecessary $ from var names, considered making the names shorter and less shouty
started improving readme