README more detailed
Links in intro
At the start show the user what he should do
rename the namespaces
compile for the gh-pages