updated README and created a heavily commented version for simple reference