update design doc misc