updated comments, documentation