From 2a3d490c03eeb0b300ad5870e70b606a80b120b9 Mon Sep 17 00:00:00 2001
From: Dylan Nelson <44685561+dylannelson@users.noreply.github.com>
Date: Fri, 14 Aug 2026 10:02:48 -0400
Subject: [PATCH 1/3] trying link change

---
 docs/contributing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/contributing.rst b/docs/contributing.rst
index c917c8473..3e2570cbc 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -117,7 +117,7 @@ homepage <https://git-scm.com/>`_).
     Git has lots and lots of commands, each with lots and lots of options. Even if we
     can cover some of them throughout this guide, your best friend for figuring out
     to do things with Git may be Google, and in particular
-    `StackOverflow <https://stackoverflow.com/>`_.
+    `StackOverflow <https://stackoverflow.com/questions>`_.
 
 Configure your environment to authenticate with GitHub from Git. This is a
 complicated process, so we suggest that you refer to the details in the

From b3fb7e69586440319d7bf66c7f34e1f01dfaa2b6 Mon Sep 17 00:00:00 2001
From: Dylan Nelson <44685561+dylannelson@users.noreply.github.com>
Date: Fri, 14 Aug 2026 10:55:57 -0400
Subject: [PATCH 2/3] added links to ignore list

---
 docs/conf.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 7dbde46aa..a7ab0b6b5 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -245,6 +245,8 @@ def __getattr__(cls, name):
     r"https://healpix.sourceforge.io/*",
     r"https://zenodo.org/*",
     r"https://doi.org/10.5281/zenodo*",
+    r"https://stackoverflow.com/*",  # Cloudflare bot protection
+    r"https://doi.org/10.1137/*",  # SIAM DOIs -> epubs.siam.org blocks bots
     # More URLs as needed
 ]
 

From 5b3c0d10b1d6fba5fcfe08d1731374e371897f73 Mon Sep 17 00:00:00 2001
From: Dylan Nelson <44685561+dylannelson@users.noreply.github.com>
Date: Fri, 14 Aug 2026 11:25:05 -0400
Subject: [PATCH 3/3] changed how links are formatted on the new page

---
 docs/api.rst                      | 10 ++++++++++
 docs/citations-for-algorithms.rst | 22 +++++++++++-----------
 2 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/docs/api.rst b/docs/api.rst
index 2addaabd8..088d3c7cf 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -151,6 +151,8 @@ Connectivity
    Grid.node_face_connectivity
 
 
+.. _descriptors:
+
 Descriptors
 ~~~~~~~~~~~
 .. autosummary::
@@ -565,6 +567,8 @@ Azimuthal aggregations apply an aggregation (i.e. averaging) along circles of co
    UxDataArray.azimuthal_mean
 
 
+.. _zonal-average:
+
 Zonal Average
 ~~~~~~~~~~~~~
 .. autosummary::
@@ -586,6 +590,8 @@ Weighted
 Spherical Geometry
 ------------------
 
+.. _intersections:
+
 Intersections
 ~~~~~~~~~~~~~
 
@@ -597,6 +603,8 @@ Intersections
    grid.intersections.get_number_of_intersections
 
 
+.. _arcs:
+
 Arcs
 ~~~~
 
@@ -610,6 +618,8 @@ Arcs
    grid.arcs.on_minor_arc
 
 
+.. _compensated-arithmetic:
+
 Compensated Arithmetic
 ----------------------
 
diff --git a/docs/citations-for-algorithms.rst b/docs/citations-for-algorithms.rst
index 2aa7d73df..6b5362ab4 100644
--- a/docs/citations-for-algorithms.rst
+++ b/docs/citations-for-algorithms.rst
@@ -74,54 +74,54 @@ Algorithm-to-Publication Mapping
    * - Documentation section
      - API or implementation
      - Required citation(s)
-   * - `Descriptors <api.html#descriptors>`__
+   * - :ref:`Descriptors <descriptors>`
      - :py:attr:`~uxarray.Grid.bounds`
 
        :py:attr:`~uxarray.Grid.face_bounds_lon`
 
        :py:attr:`~uxarray.Grid.face_bounds_lat`
      - |cite-gmd|
-   * - `Zonal Average <api.html#zonal-average>`__
+   * - :ref:`Zonal Average <zonal-average>`
      - All zonal-average remapping implementations (e.g. :py:meth:`~uxarray.UxDataArray.zonal_mean`)
      - |cite-siam|
-   * - `Spherical Geometry: Intersections <api.html#intersections>`__
+   * - :ref:`Spherical Geometry: Intersections <intersections>`
      - All spherical-intersection APIs in this section (:py:func:`~uxarray.grid.intersections.gca_gca_intersection`, :py:func:`~uxarray.grid.intersections.gca_const_lat_intersection`, :py:func:`~uxarray.grid.intersections.get_number_of_intersections`)
      - **Cite both:**
 
        |cite-gmd|
 
        |cite-siam|
-   * - `Spherical Geometry: Arcs <api.html#arcs>`__
+   * - :ref:`Spherical Geometry: Arcs <arcs>`
      - :py:func:`~uxarray.grid.arcs.in_between`
 
        :py:func:`~uxarray.grid.arcs.point_within_gca`
      - No new citation required. Expected to be removed in a future release.
-   * - `Spherical Geometry: Arcs <api.html#arcs>`__
+   * - :ref:`Spherical Geometry: Arcs <arcs>`
      - :py:func:`~uxarray.grid.arcs.extreme_gca_latitude`
      - |cite-gmd|
-   * - `Spherical Geometry: Arcs <api.html#arcs>`__
+   * - :ref:`Spherical Geometry: Arcs <arcs>`
      - :py:func:`~uxarray.grid.arcs.orient3d_on_sphere`
 
        :py:func:`~uxarray.grid.arcs.on_minor_arc`
      - |cite-shewchuk|
-   * - `Compensated Arithmetic <api.html#compensated-arithmetic>`__
+   * - :ref:`Compensated Arithmetic <compensated-arithmetic>`
      - :py:func:`~uxarray.utils.computing.two_sum`
      - |cite-knuth|
-   * - `Compensated Arithmetic <api.html#compensated-arithmetic>`__
+   * - :ref:`Compensated Arithmetic <compensated-arithmetic>`
      - :py:func:`~uxarray.utils.computing.two_prod`
      - |cite-dekker|
-   * - `Compensated Arithmetic <api.html#compensated-arithmetic>`__
+   * - :ref:`Compensated Arithmetic <compensated-arithmetic>`
      - :py:func:`~uxarray.utils.computing.diff_of_products`
      - **Cite both:**
 
        |cite-higham|
 
        |cite-jeannerod|
-   * - `Compensated Arithmetic <api.html#compensated-arithmetic>`__
+   * - :ref:`Compensated Arithmetic <compensated-arithmetic>`
      - :py:func:`~uxarray.utils.computing.accucross`
 
        :py:func:`~uxarray.utils.computing.accucross_pair`
      - |cite-gmd|
-   * - `Compensated Arithmetic <api.html#compensated-arithmetic>`__
+   * - :ref:`Compensated Arithmetic <compensated-arithmetic>`
      - :py:func:`~uxarray.utils.computing.acc_sqrt_re`
      - |cite-rump|