Update documentation for proper dev env setup

[Hermanio]

Current documentation is a bit lacking, needs to be checked and improved to avoid problems when new contributors want to join the project.

[artizirk]

What do you want to improve on it? jekyll install instructions should work for windows and ubuntu users. Others are on their own anyway.