doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.
this doesn't need indenting.