docs/source/foundations/io.rst: total reorganization
docs/source/foundations/io.rst: total reorganization

Use all of our new tools and understanding to organize all of the Path docs
in a better way that allows us to leverage our docstrings.

pkgw/pwkit