Updated documentation of what is going on