diff --git a/source/discussions/setup-py-deprecated.rst b/source/discussions/setup-py-deprecated.rst
index 25bba70a9..f60e39dd8 100644
--- a/source/discussions/setup-py-deprecated.rst
+++ b/source/discussions/setup-py-deprecated.rst
@@ -38,7 +38,11 @@ What commands should be used instead?
 +---------------------------------+                                        |
 | ``python setup.py bdist_wheel`` |                                        |
 +---------------------------------+----------------------------------------+
+| | ``python setup.py --version`` |  ``python -m setuptools_scm``          |
+| | (when using setuptools-scm_)  |                                        |
++---------------------------------+----------------------------------------+
 
+.. _setuptools-scm: https://setuptools-scm.readthedocs.io
 
 .. [#needs-build] This requires the :ref:`build` dependency.
     It is recommended to always build and publish both the source distribution
diff --git a/source/guides/modernize-setup-py-project.rst b/source/guides/modernize-setup-py-project.rst
index 98f0d78c0..058e20ad7 100644
--- a/source/guides/modernize-setup-py-project.rst
+++ b/source/guides/modernize-setup-py-project.rst
@@ -37,7 +37,11 @@ and their recommended replacement commands should be used instead:
 +---------------------------------+                                        |
 | ``python setup.py bdist_wheel`` |                                        |
 +---------------------------------+----------------------------------------+
+| | ``python setup.py --version`` |  ``python -m setuptools_scm``          |
+| | (when using setuptools-scm_)  |                                        |
++---------------------------------+----------------------------------------+
 
+.. _setuptools-scm: https://setuptools-scm.readthedocs.io
 
 For more details: