first draft of design doc

technically complete but should be expanded