ECMS-5508 added some comments to public methods