added some comments and little wording changes [MJ-677]