doc: Cleanup.

Remove ~~~ for code block specification. Use /// Over /** */ for doc
blocks.
doc: Methods for result::Result.
doc: Methods for option::Option
doc: Backticks and spelling mistakes.
doc: Remove "see above".
auto merge of #17339 : treeman/rust/doc-things, r=alexcrichton

Also some cleanup to conform to documentation style.