Review documentation

Review documentation and polish the documentation for release v1.8

Check whether the doc for each submodules is up to date. Update the build / install instructions with CMake.