doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.