updated README and added comments to decision maker