updated comments on document