Packaging doc: Add missing index file, improve main page description.

Also promote notices from distutils doc to deprecation boxes.