diff --git a/doc/api/top-level.rst b/doc/api/top-level.rst
index 5306a636764..c6f45c1863c 100644
--- a/doc/api/top-level.rst
+++ b/doc/api/top-level.rst
@@ -6,6 +6,12 @@ Top-level functions
 Computation
 -----------
 
+.. note::
+
+   For worked examples and advanced usage of ``apply_ufunc``, see the
+   :doc:`User Guide on Computation </user-guide/computation>`, and the
+   `apply_ufunc tutorial <https://tutorial.xarray.dev/advanced/apply_ufunc/apply_ufunc.html>`_.
+
 .. autosummary::
    :toctree: ../generated/