Documentation

Updated the documentation with what I figured out during my trial run. I'll be keen to know whether my understanding of how things work reflect reality :-)