readme update and comment cleaning