doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.
The `Ident` and `Self`s here should have backticks.