Documentation fixes

Better documentation and typo in example fix