doc: Method examples for Result and Option

Also some cleanup to conform to documentation style.
Same here, `Self` could use backticks.