update README with changes on Design Decisions;