updated readme and design doc