updated the design doc -- final