minor tidy and update docs.  drop example