adjust and refurbish README
adjust design goals
rename info on source code
add links to documentation
make 'how to run the code' more precise
Merge pull request #3 from PrometheusPi/refurbish-doc

Refurbish doc