design doc updated