I think it would be nice if the README had all the contents that are in FAQ, it's makes more sense for me, what you think? From the README we would be able to just add some links for the specific files for each section.

As this repository would be basically a website, our navigation is broken now.