Merge pull request #897 from henryiii/patch-3

docs: update suggestion for build and cibuildwheel

Author: webknjaz

source/conf.py

@@ -379,8 +379,8 @@
     'python': ('https://docs.python.org/3', None),
     'python2': ('https://docs.python.org/2', None),
     'pip': ('https://pip.pypa.io/en/latest/', None),
-    'setuptools': ('https://setuptools.rtfd.io/en/latest/', None),
-    'twine': ('https://twine.rtfd.io/en/stable/', None),
+    'setuptools': ('https://setuptools.readthedocs.io/en/latest/', None),
+    'twine': ('https://twine.readthedocs.io/en/stable/', None),
 }
 
 

source/guides/tool-recommendations.rst

@@ -46,12 +46,14 @@ Installation tool recommendations
 Packaging tool recommendations
 ==============================
 
-* Use :ref:`setuptools` to define projects and create :term:`Source Distributions
-  <Source Distribution (or "sdist")>`. [5]_ [6]_
+* Use :ref:`setuptools` to define projects. [5]_ [6]_
 
-* Use the ``bdist_wheel`` :ref:`setuptools` extension available from the
-  :ref:`wheel project <wheel>` to create :term:`wheels <Wheel>`.  This is
-  especially beneficial, if your project contains binary extensions.
+* Use :ref:`build` to create :term:`Source Distributions
+  <Source Distribution (or "sdist")>` and :term:`wheels <Wheel>`.
+
+If you have binary extensions and want to distribute wheels for multiple
+platforms, use :ref:`cibuildwheel` as part of your CI setup to build
+distributable wheels.
 
 * Use `twine <https://pypi.org/project/twine>`_ for uploading distributions
   to :term:`PyPI <Python Package Index (PyPI)>`.