moar #42 cleanup - documentation, examples, tests