re-work descriptions based on feedback from @matin