We need the documentation separated in the readme.md file, contributing.md and Github pages.

The user docs are the more extensive task that should be divided into small tasks.