DOC Add links to AgglomerativeClustering examples in docs and the user guide (#28885)

yuanx749 · web-flow · commit db58c6f70efd · 2024-04-25T13:54:27.000+02:00
diff --git a/doc/modules/clustering.rst b/doc/modules/clustering.rst
@@ -702,6 +702,9 @@ Single linkage can also perform well on non-globular data.
   * :ref:`sphx_glr_auto_examples_cluster_plot_digits_linkage.py`: exploration of
     the different linkage strategies in a real dataset.
 
+  * :ref:`sphx_glr_auto_examples_cluster_plot_linkage_comparison.py`: exploration of
+    the different linkage strategies in toy datasets.
+
 
 Visualization of cluster hierarchy
 ----------------------------------
@@ -714,6 +717,10 @@ of the data, though more so in the case of small sample sizes.
     :target: ../auto_examples/cluster/plot_agglomerative_dendrogram.html
     :scale: 42
 
+.. topic:: Examples:
+
+  * :ref:`sphx_glr_auto_examples_cluster_plot_agglomerative_dendrogram.py`
+
 
 Adding connectivity constraints
 -------------------------------
@@ -1042,7 +1049,7 @@ scales by building an alternative representation of the clustering problem.
 .. topic:: Examples:
 
     * :ref:`sphx_glr_auto_examples_cluster_plot_hdbscan.py`
-  
+
 Mutual Reachability Graph
 -------------------------
 
diff --git a/sklearn/cluster/_agglomerative.py b/sklearn/cluster/_agglomerative.py
@@ -846,6 +846,9 @@ class AgglomerativeClustering(ClusterMixin, BaseEstimator):
         .. versionadded:: 0.20
             Added the 'single' option
 
+        For examples comparing different `linkage` criteria, see
+        :ref:`sphx_glr_auto_examples_cluster_plot_linkage_comparison.py`.
+
     distance_threshold : float, default=None
         The linkage distance threshold at or above which clusters will not be
         merged. If not ``None``, ``n_clusters`` must be ``None`` and
@@ -860,6 +863,9 @@ class AgglomerativeClustering(ClusterMixin, BaseEstimator):
 
         .. versionadded:: 0.24
 
+        For an example of dendrogram visualization, see
+        :ref:`sphx_glr_auto_examples_cluster_plot_agglomerative_dendrogram.py`.
+
     Attributes
     ----------
     n_clusters_ : int
