doc update for major revision