Merge pull request #1634 from mattip/pypy3.8

Update and reshuffle info about PyPy

Author: isuruf

src/maintainer/knowledge_base.rst

@@ -1148,23 +1148,7 @@ because these symbols are in fact available. To do so, add
 PyPy builds
 ===========
 
-To use the PyPy 3.6 or 3.7 builds you can do the following,
-
-.. code-block:: bash
-
-   conda create -n pypy36  pypy python=3.6
-   conda create -n pypy37  pypy python=3.7
-
-.. note::
-
-   As of March 8 2020, if you are using defaults as a low priority channel,
-   then you need to use strict channel priority as the metadata in defaults
-   has not been patched yet which allows cpython extension packages to be
-   installed alongside pypy.
-
-.. code-block:: bash
-
-   conda config --set channel_priority strict
+See :ref:`pypy` in the user docs for more info about PyPy and ``conda-forge``.
 
 To build your python package for pypy, wait for the bot to send a
 PR and contact ``conda-forge/bot`` team if a PR is not sent after the

src/user/announcements.rst

@@ -10,10 +10,14 @@ Our announcements are published to an RSS feed `here <https://conda-forge.org/do
 
 :2022-03-28: PyPy 3.8+3.9 Migration
 
-    Our bots will begin migrating all feedstocks with PyPy enabled
-    to 3.8+3.9. We will be dropping PyPy 3.7 builds in each feedstock
-    as the newer versions are added. As usual, you can track the status
-    of the migration on our status page. 
+    We have begun rolling out packages built for PyPy3.8 and PyPy3.9. This work
+    may take a few weeks. See :ref:`pypy` in the user docs for information on how to
+    set up a PyPy environment. Please report issues to the PyPy developers at
+    https://foss.heptapod.net/pypy/pypy/issues. We are also dropping PyPy3.7
+    in each feedstock as the newer versions of PyPy are added. New versions of
+    migrated feedstocks will not be built for PyPy3.7 and that version of the
+    python interpreter will not be receiving updates. As usual, you can track the
+    status of the migration on our status page.
 
 :2022-03-06: Travis CI Usage Deprecated for ``win_*``, ``osx_*``, and ``linux_64`` Platforms
 

src/user/tipsandtricks.rst

@@ -152,3 +152,36 @@ In order to override the default behavior, a user can set the environment variab
    Note that you should select the cudatoolkit version most appropraite for your GPU; currently, we have "10.2", "11.0", "11.1", and "11.2" builds available, where the "11.2" builds are compatible with all cudatoolkits>=11.2. (At the time of writing, there seems to be a bug in how the cuda builds are resolved by mamba, defaulting to cudatoolkit==10.2; thus, it is prudent to be as explicit as possible like above or by adding ``cudatoolkit>=11.2`` or similar to the line above.) 
 
 For context, installing TensorFlow 2.7.0 with ``CONDA_CUDA_OVERRIDE="11.2" mamba install "tensorflow==2.7.0=cuda*" -c conda-forge`` results in approximately 2 GB of packages to download while ``CONDA_CUDA_OVERRIDE="11.2" mamba install "tensorflow=2.7.0=cpu*" -c conda-forge`` results in approximately 200 MB to download. That is a significant bandwidth and storage wasted if one only needs the ``-cpu`` variant! 
+
+
+.. _pypy:
+
+Using PyPy as an interpreter
+============================
+The ``conda-forge`` channel supports creating and installing packages into
+environments using the `PyPy interpreter`_. Many packages are already
+available. You need to enable the ``conda-forge`` channel and use
+the ``pypy`` identifier when creating your environment:
+
+.. code-block:: shell
+
+    $ conda create -c conda-forge -n my-pypy-env pypy python=3.8
+    $ conda activate my-pypy-env
+
+Currently supported python versions are 3.8 and 3.9. Support for ``pypy3.7``
+has been dropped. While you can still create a python 3.7 environment, you
+you will not be getting updates as new package versions are released (including
+pypy itself).
+
+.. note::
+
+   As of March 8 2020, if you are using defaults as a low priority channel,
+   then you need to use strict channel priority as the metadata in defaults
+   has not been patched yet which allows cpython extension packages to be
+   installed alongside pypy.
+
+.. code-block:: bash
+
+   $ conda config --set channel_priority strict
+
+.. _`PyPy interpreter`: https://www.pypy.org