add design decisions to read me