update README with "Design Decision" section;
update README on "Design Decisions";
update README with table of contents;