Documentation improvements (#669)

* Improved MANUAL.md and minor fix on README.md

* Minor improvements on MANUAL.md

Author: fmachado