updates the design doc a bit more