Updates to design doc

and there will be for a long time