Merge branch 'conda-forge:main' into main

Author: Uma-95

.ci_scripts/update_docs

@@ -33,7 +33,11 @@ make html SPHINXOPTS="-W --keep-going -n"
 linkcheck_failed=0
 make linkcheck > /dev/null || linkcheck_failed=1
 python ../.ci_scripts/display_linkcheck.py _build/linkcheck/output.json
-test "$linkcheck_failed" -eq 0
+
+if [[ "${GHREF}" != "refs/heads/main" ]]; then
+  test "$linkcheck_failed" -eq 0
+fi
+
 mv _build/html ../docs
 rm -rf _build
 popd

.github/workflows/deploy.yml

@@ -29,6 +29,8 @@ jobs:
         shell: bash -l {0}
         run: |
           source ./.ci_scripts/update_docs
+        env:
+          GHREF: ${{ github.ref }}
 
       - name: deploy
         if: github.ref == 'refs/heads/main' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')

css/theme.css

@@ -416,3 +416,9 @@ body {
   max-width: 100%;
   height: auto;
 }
+
+/*  https://stackoverflow.com/a/25517025 */
+.vcenter {
+    display: flex;
+    align-items: center;
+}

index.html.tmpl

@@ -8,7 +8,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="description" content="">
     <meta name="author" content="">
-    
+
     <link rel="shortcut icon" href="img/favicon.ico">
 
     <title>conda-forge | community driven packaging for conda</title>
@@ -121,6 +121,28 @@
                   each repository, also known as a feedstock, automatically
                   builds its own recipe in a clean and repeatable way on Windows, Linux and OSX.
                 </p>
+            </div>
+        </div>
+
+        <div class="row vcenter" style="display: none;" id="stats1">
+            <div class="col-md-4 col-md-offset-2 padded">
+              <p class="text-center" id="stats-downloads"></p>
+            </div>
+            <div class="col-md-4 padded">
+              <p class="text-center" id="stats-members"></p>
+            </div>
+        </div>
+        <div class="row vcenter" style="display: none;" id="stats2">
+            <div class="col-md-4 col-md-offset-2 padded">
+              <p class="text-center" id="stats-data"></p>
+            </div>
+            <div class="col-md-4 padded">
+              <p class="text-center" id="stats-issues-prs"></p>
+            </div>
+        </div>
+
+        <div class="row">
+            <div class="col-lg-8 col-lg-offset-2 padded">
                 <p>
                   The built distributions are uploaded to <a href="http://anaconda.org/conda-forge">anaconda.org/conda-forge</a>
                   and can be <a href="http://conda.pydata.org/docs/intro.html">installed with conda</a>. For example, to install a
@@ -261,6 +283,9 @@
                           The build and upload processes take place in the feedstock, and once complete the package will be available on the conda-forge channel.</li>
                       </ul>
                     </p>
+                    <p>
+                        Please consider joining our <a href="https://gitter.im/conda-forge/conda-forge.github.io">Gitter</a> channel if you want to ask something, need help, or just want to chat with our maintainers. We would love to see you there!
+                    </p>
                 </div>
             </div>
         </div>
@@ -394,6 +419,9 @@
     <!-- Custom Theme JavaScript -->
     <script src="js/theme.js"></script>
 
+    <!-- stats -->
+    <script src="js/stats.js"></script>
+
 </body>
 
 </html>

js/stats.js

@@ -0,0 +1,54 @@
+function loadStatsJSON (url, callback) {
+  var xobj = new XMLHttpRequest()
+  xobj.overrideMimeType('application/json')
+  xobj.open('GET', url, true)
+  xobj.onreadystatechange = function () {
+    if (xobj.readyState === 4 && xobj.status === 200) {
+      // Required use of an anonymous callback as .open will NOT return a value
+      // but simply returns undefined in asynchronous mode
+      callback(xobj.responseText)
+    }
+  }
+  xobj.send(null)
+}
+
+function displayStatsJSON (reportText) {
+  var stats = JSON.parse(reportText)
+
+  var div = document.getElementById('stats-downloads')
+  var mlns = stats.downloads.month / 1e6
+  var blns = stats.downloads.all / 1e9
+  div.innerHTML = (
+    mlns.toFixed(0) + ' million monthly downloads<br>' +
+    blns.toFixed(1) + ' billion all-time downloads'
+  )
+
+  div = document.getElementById('stats-members')
+  div.innerHTML = (
+    stats.n_members_core + ' core devs<br>' +
+    stats.n_members_staged_recipes + ' staged-recipes maintainers<br>' +
+    (stats.n_members / 1e3).toFixed(1) + 'k feedstock maintainers'
+  )
+
+  div = document.getElementById('stats-data')
+  div.innerHTML = (
+    (stats.n_repos / 1e3).toFixed(1) + 'k feedstocks<br>' +
+    (stats.n_packages / 1e3).toFixed(1) + 'k packages<br>' +
+    (stats.n_artifacts / 1e3).toFixed(0) + 'k artifacts'
+  )
+
+  div = document.getElementById('stats-issues-prs')
+  div.innerHTML = (
+    ((stats.n_prs + stats.n_issues) / 1e3).toFixed(1) + 'k issues+PRs<br>' +
+    ((stats.n_open_prs + stats.n_open_issues) / 1e3).toFixed(1) + 'k/' +
+    ((stats.n_closed_prs + stats.n_closed_issues) / 1e3).toFixed(1) + 'k open/closed'
+  )
+
+  div = document.getElementById('stats1')
+  div.style.display = ''
+  div = document.getElementById('stats2')
+  div.style.display = ''
+}
+
+var url = 'https://raw.githubusercontent.com/conda-forge/by-the-numbers/main/data/live_counts.json'
+loadStatsJSON(url, displayStatsJSON)

src/conf.py

@@ -112,6 +112,7 @@
 todo_include_todos = True
 
 # ---- Options for link validation --------
+user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:25.0) Gecko/20100101 Firefox/25.0'
 
 anchor_check_fps = [
     r'https://conda-forge.org/status/#armosxaddition$',

src/user/tipsandtricks.rst

@@ -137,22 +137,21 @@ To verify that the correct platform is being used, run the following commands af
 Installing CUDA-enabled packages like TensorFlow and PyTorch 
 ============================================================
 
-In conda-forge, some packages are available with GPU support. These packages not only take significantly longer to compile and build, but they also result in rather large binaries that users then download. As an effort to maximize accessibility for users with lower connection and/or storage bandwidth, there is an ongoing effort to limit installing packages compiled for GPUs unnecessarily on CPU-only machines by default. This is accomplished by adding a run dependency, ``__cuda``, that detects if the local machine has a GPU. However, this introduces challenges to users who may prefer to still download and use GPU-enabled packages even on a non-GPU machine. For example, login nodes on HPCs often do not have GPUs and their compute counterparts with GPUs often do not have internet access. In this case, a user can override the default setting via the environment variable ``CONDA_CUDA_OVERRIDE`` to install GPU packages on the login node to be used later on the compute node. At the time of writing (February 2022), we have concluded this safe default behavior is best for most of conda-forge users, with an easy override option available and documented. Please let us know if you have thoughts on or issues with this.
+In conda-forge, some packages are available with GPU support. These packages not only take significantly longer to compile and build, but they also result in rather large binaries that users then download. As an effort to maximize accessibility for users with lower connection and/or storage bandwidth, there is an ongoing effort to limit installing packages compiled for GPUs unnecessarily on CPU-only machines by default. This is accomplished by adding a run dependency, ``__cuda``, that detects if the local machine has a GPU. However, this introduces challenges to users who may prefer to still download and use GPU-enabled packages even on a non-GPU machine. For example, login nodes on HPCs often do not have GPUs and their compute counterparts with GPUs often do not have internet access. In this case, a user can override the default setting via the environment variable ``CONDA_OVERRIDE_CUDA`` to install GPU packages on the login node to be used later on the compute node. At the time of writing (February 2022), we have concluded this safe default behavior is best for most of conda-forge users, with an easy override option available and documented. Please let us know if you have thoughts on or issues with this.
 
-In order to override the default behavior, a user can set the environment variable ``CONDA_CUDA_OVERRIDE`` like below to install TensorFlow with GPU support even on a machine with CPU only.
+In order to override the default behavior, a user can set the environment variable ``CONDA_OVERRIDE_CUDA`` like below to install TensorFlow with GPU support even on a machine with CPU only.
 
 .. code-block:: shell
 
-     CONDA_CUDA_OVERRIDE="11.2" conda install "tensorflow==2.7.0=cuda112*" -c conda-forge
+     CONDA_OVERRIDE_CUDA="11.2" conda install "tensorflow==2.7.0=cuda112*" -c conda-forge
      # OR
-     CONDA_CUDA_OVERRIDE="11.2" mamba install "tensorflow==2.7.0=cuda112*" -c conda-forge
+     CONDA_OVERRIDE_CUDA="11.2" mamba install "tensorflow==2.7.0=cuda112*" -c conda-forge
 
 .. note::
 
-   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! 
+   You should select the cudatoolkit version most appropriate 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 (Mar 2022), 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 the TensorFlow 2.7.0 CUDA-enabled variant, ``tensorflow==2.7.0=cuda*``, results in approximately 2 GB of packages to download while the CPU variant, ``tensorflow=2.7.0=cpu*``, results in approximately 200 MB to download. That is a significant bandwidth and storage wasted if one only needs the CPU only variant!
 
 .. _pypy: