updated comments for doc