first draft of pwio::utils docs
doc tweaks