Add debian/ubuntu installation guide

This way we can bind our documentation to the source code.
Things will never get out of sync and we can (hopefully) sometime
automatically take this documentation and put it on a fancy help page
somewhere.
Merge pull request #2124 from opf/hotfix/user_guide

Add Debian/Ubuntu Installation Guide
Merge branch 'release/4.0' into dev