http://docs.python.org/dev/documenting/building.html also needs to be updated (it still mentions Subversion and probably obsolete versions of Sphinx and other packages).  If you are going to add the text proposed in your second message, you might want to drop a couple of "p"s from there.