CORE-4066: added more documentation