more review feedback.

* atomic file renames.
* more docs.
* cleaned up example args.