fixes ACTS-166 by changing the default value fixes ACTS-165 and ACTS-167 by adding appropriate documentation