update read me with design decision