design doc

purpose and testing
updated readme