Merge branch 'update-docs' into 'belenos'

Update docs

Update docs in order to follow the current workflow

Some ideas taken from the joind.in project

Video showing the process is avaliable here:
https://asciinema.org/a/587sed1f4fi0cj5lia2p9uoi5

See merge request !109