update manual for linear migration