Improve documentation contents and structure

[joansola]

Hi @artivis . I open this issue so that when I have some time I want to work on the doc website to improve it. I hope I do not take too long to dig into it.