std: Improve docs for mod 'result'

This adds some fairly extensive documentation for `Result`.

I'm using manual links to other rustdoc html pages a bit.