semi-final doc update