minor changes in documentation files

removed some typos. Some (few) comments in the documentation parts of the files.