doc: move documentation from inside the pacakge to the root

It's really boring to go down inside the pacakge to read the about.
I have just moved the first part on what this addon achieve.
The rest (tests) is still inside the package.
I have also updated the setup.py to keep same results on long
description.
buildout: update it to use github and include sample.