added comments
preparation for repo merge