Add a section about proxy support

docs/index.rst

@@ -151,6 +151,31 @@ on a CI/build server).
 * ``TWINE_NON_INTERACTIVE`` - Do not interactively prompt for username/password
   if the required credentials are missing.
 
+Proxy Support
+^^^^^^^^^^^^^
+
+Twine allows you to upload your distributions with/without proxy via
+these environment variables:
+
+* ``HTTP_PROXY`` - Upload your distributions with HTTP proxy.
+* ``HTTPS_PROXY`` - Upload your distributions with HTTPS proxy.
+* ``NO_PROXY`` - Upload your distributions without proxy.
+
+For example:
+
+.. code-block:: bash
+
+   export HTTPS_PROXY=socks5://user:pass@host:port
+
+   twine upload dist/*
+
+
+For more information, see the Requests documentation on
+`proxies <https://docs.python-requests.org/en/master/user/advanced/#proxies>`_ and
+`SOCKS <https://docs.python-requests.org/en/master/user/advanced/#socks>`_ , and
+`an in-depth article about proxy environment variables
+<https://about.gitlab.com/blog/2021/01/27/we-need-to-talk-no-proxy/>`_.
+
 Keyring Support
 ---------------