updated design doc -- part B & C