[KARAF-2511] Start to review and update the developers guide