README.md grew large so it would be useful to structure the docs in a gh-pages based site. We can use: jekyll, mkdocs or hugo as doc site generator