@jezdez, to be clear, this is for the "Reference Guide" portion, which I was intending to be a mostly "mechanical" rendering of the facts. The "User Guide" can be for more topical prose that covers the 80% cases.

see here for context : https://gist.github.com/qwcode/8431828
the "Pypa Template" idea is part of my plan on making the PUG links to Pypa docs appear more consistent and less jolting.  I was planning on shuffling pip as well to this structure.

this may seem bit silly for virtualenv, since it's so small, but for pip and setuptools, I think it's significant.