COOPR-492: made changes according to style of documentation