updated codebase and README to presentable to the outside world