cmake: change default CMAKE_BUILD_TYPE to RelWithDebInfo

in the past some users run e.g. benchmarks and was surprised with
the results. Using release version should omit that problem.
Documentation is updated as well to point users with proper CMake parameter.