diff --git a/docs/chart_template_guide/yaml_techniques.md b/docs/chart_template_guide/yaml_techniques.md
index b581218bd..74c64231c 100644
--- a/docs/chart_template_guide/yaml_techniques.md
+++ b/docs/chart_template_guide/yaml_techniques.md
@@ -353,3 +353,10 @@ coffees:
 
 Because Helm and Kubernetes often read, modify, and then rewrite YAML files, the
 anchors will be lost.
+
+:::info
+For sharing snippets across charts,
+use [library charts](/topics/library_charts.md) instead of YAML anchors.
+Library charts are designed for reuse,
+and aren't subject to the round-trip pitfall described above.
+:::
diff --git a/versioned_docs/version-3/chart_template_guide/yaml_techniques.md b/versioned_docs/version-3/chart_template_guide/yaml_techniques.md
index b581218bd..74c64231c 100644
--- a/versioned_docs/version-3/chart_template_guide/yaml_techniques.md
+++ b/versioned_docs/version-3/chart_template_guide/yaml_techniques.md
@@ -353,3 +353,10 @@ coffees:
 
 Because Helm and Kubernetes often read, modify, and then rewrite YAML files, the
 anchors will be lost.
+
+:::info
+For sharing snippets across charts,
+use [library charts](/topics/library_charts.md) instead of YAML anchors.
+Library charts are designed for reuse,
+and aren't subject to the round-trip pitfall described above.
+:::