comment and fix some parts of the documentation, thanks to Harsh Trivedi