doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.
I would say 'above' isn't clear here. I know you're just fixing formatting though, so it's not the worst thing...