jh - updated design doc