In my experience, creating these super huge Readme files will go south sooner or later... hard to maintain, hard to refactor etc...
Consider using GitBook, all in all Dan Abramov Redux guide is really good example how things should look like IMHO.
thx