small docs and example tidy up