revised design doc