added and updated fns, added additional commenting, and updated readme