doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.
I actually removed the references. I guess I could expand on 'above' instead, but then that should be added to a couple more places. I think it's fair to search out the documentation for the root level without having to specify it?