updated comments on entire code base