Fix documentation: grammar, typos, formatting, and links

[DimitriPapadopoulos]

Should both roles remain documented?

wheel/docs/index.rst

Lines 12 to 19 in 8b6fa74

	It has two different roles:
	#. A setuptools_ extension for building wheels that provides the
	``bdist_wheel`` setuptools command
	#. A command line tool for working with wheel files
	.. _PEP 427: https://www.python.org/dev/peps/pep-0427/
	.. _setuptools: https://pypi.org/project/setuptools/

The README has been updated so the documentation seems inconsistent:

wheel/README.rst

Lines 14 to 20 in 8b6fa74

	Historical note
	---------------
	This project used to contain the implementation of the setuptools_ ``bdist_wheel``
	command, but as of setuptools v70.1, it no longer needs ``wheel`` installed for that to
	work. Thus, you should install this **only** if you intend to use the ``wheel`` command
	line tool!

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 52.63%. Comparing base (8b6fa74) to head (f09b855).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #678   +/-   ##
=======================================
  Coverage   52.63%   52.63%           
=======================================
  Files          14       14           
  Lines        1121     1121           
=======================================
  Hits          590      590           
  Misses        531      531           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[agronholm]

Looks good so far. Do you plan to add more commits to this?

[DimitriPapadopoulos]

I only have a question about the documenting role of wheel as a setuptools extension.

[agronholm]

In 2024 I pushed a change to setuptools that vendors wheel, making this project unnecessary to be installed in order to build wheels. I even published some versions of wheel that got rid of the bdist_wheel command entirely, but had to back out of that as there were many projects out there that for some bizarre reason wanted to update wheel but not setuptools, causing the bdist_wheel command to not work at all. But I don't want to even hint at the existence of bdist_wheel here, as many developers are poor at reading the documentation properly and will jump to the wrong conclusions, based on my real-world experience.

[DimitriPapadopoulos]

Thank you. Then I understand the two roles should remain here:

wheel/docs/index.rst

Lines 12 to 19 in 8b6fa74

	It has two different roles:
	#. A setuptools_ extension for building wheels that provides the
	``bdist_wheel`` setuptools command
	#. A command line tool for working with wheel files
	.. _PEP 427: https://www.python.org/dev/peps/pep-0427/
	.. _setuptools: https://pypi.org/project/setuptools/

[agronholm]

Actually, I had forgotten about that documentation page altogether. I don't want to advertise wheel as a setuptools extension, as it should no longer be used in that manner. The index page should probably be rewritten.

[agronholm]

Looks good. I'll make some modifications on my own but I won't bother you with those. Thanks!