last updates to the design doc