updated README and directory code looks more like a program than a list of defined variables