style tweaks, update examples, todo: docs