The documentation for Python is mediocre at best, which is a wart of how documenting Python works. I think the newer Sphynx site is actually a regression from what they had in the Python 2.5 days.