Better documentation on compiling from source and 'opam init'

Closes #1842