heres the design doc and edited readme