[Docs] fully replace python.org/distutils docs

Summary

https://docs.python.org/3/distutils/setupscript.html comes up high in a search, looks like authoritative official guidance on the best way to configure a python project, and it tells people to use setup.py

This page says it will go away when all of the information is available in setuptools documentation:

Note This document is being retained solely until the setuptools documentation at https://setuptools.readthedocs.io/en/latest/setuptools.html independently covers all of the relevant information currently included here.

Additional Information

Not all the documentation should be retained in the setuptools docs.

To break the work up, here are the chapters in distutils docs, and roughly equivalent page in setuptools, if one exists.

• 1. An Introduction to Distutils](https://docs.python.org/3/distutils/introduction.html)
  ?

• 2. Writing the Setup Script](https://docs.python.org/3/distutils/setupscript.html)
  ?

• 3. Writing the Setup Configuration File](https://docs.python.org/3/distutils/configfile.html)
  https://setuptools.pypa.io/en/latest/userguide/declarative_config.html

• 4. Creating a Source Distribution](https://docs.python.org/3/distutils/sourcedist.html)
  https://setuptools.pypa.io/en/latest/userguide/miscellaneous.html

• 5 Creating Built Distributions](https://docs.python.org/3/distutils/builtdist.html)

• 6. Distutils Examples](https://docs.python.org/3/distutils/examples.html)
  https://setuptools.pypa.io/en/latest/userguide/quickstart.html?

• 7. Extending Distutils](https://docs.python.org/3/distutils/extending.html)
  https://setuptools.pypa.io/en/latest/userguide/extension.html

• 8. Command Reference](https://docs.python.org/3/distutils/commandref.html)

• 9 API Reference](https://docs.python.org/3/distutils/apiref.html)

Actually deciding the docs are ready for deletion has to be done by that team, this will be tracked at https://github.com/python/cpython/issues/94249

Code of Conduct

• I agree to follow the PSF Code of Conduct

Review the nine linked Distutils chapters and the corresponding Setuptools documentation pages listed in the issue, starting with the chapters that lack an identified equivalent. Check CPython issue 94249 before changing anything, since that team must decide when the Python documentation is ready for deletion. Done means the relevant information is covered or its disposition is agreed and the Distutils documentation can be retired.