doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.
should be "Example" :smile: