improve documentation wording

(as a test push)
Fix dependencies for Debian/Ubuntu
Fix rst syntax