tweaks to design doc