From 1e27c6ecff3ce9ddc680ae64b588f6310f340909 Mon Sep 17 00:00:00 2001 From: Eduardo Diaz Date: Mon, 25 May 2026 16:37:39 +0200 Subject: [PATCH 1/2] docs(chart_template_guide): point YAML Anchors at library charts When readers reach the YAML Anchors appendix, a common motivation is DRY-ing up shared snippets across charts. Library charts are the Helm-native way to do that and aren't affected by the round-trip pitfall the section already describes. Add a short info admonition at the end of the section linking to /topics/library_charts. Mirrored in both versioned_docs/version-3 and docs (next). Signed-off-by: Eduardo Diaz --- docs/chart_template_guide/yaml_techniques.md | 6 ++++++ .../version-3/chart_template_guide/yaml_techniques.md | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/docs/chart_template_guide/yaml_techniques.md b/docs/chart_template_guide/yaml_techniques.md index 8c1149ed0e..436ad51eee 100644 --- a/docs/chart_template_guide/yaml_techniques.md +++ b/docs/chart_template_guide/yaml_techniques.md @@ -353,3 +353,9 @@ coffees: Because Helm and Kubernetes often read, modify, and then rewrite YAML files, the anchors will be lost. + +:::info +Reaching for anchors as a DRY mechanism? For sharing snippets across charts, +prefer [library charts](/topics/library_charts.md) — they are designed for +reuse and aren't affected by 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 8c1149ed0e..436ad51eee 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,9 @@ coffees: Because Helm and Kubernetes often read, modify, and then rewrite YAML files, the anchors will be lost. + +:::info +Reaching for anchors as a DRY mechanism? For sharing snippets across charts, +prefer [library charts](/topics/library_charts.md) — they are designed for +reuse and aren't affected by the round-trip pitfall described above. +::: From 4f9ac3844757155a1f7e64aad79da1d82824d69a Mon Sep 17 00:00:00 2001 From: Eduardo Diaz Date: Fri, 29 May 2026 10:07:13 +0200 Subject: [PATCH 2/2] docs(chart_template_guide): apply review copy edits to library-charts admonition MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Tighten the wording in the new YAML Anchors → library charts admonition per review feedback: lead with the recommendation ("use library charts instead of YAML anchors") and split the rationale into a second sentence. Same change mirrored in docs/ (next) and versioned_docs/version-3 (GA). Signed-off-by: Eduardo Diaz --- docs/chart_template_guide/yaml_techniques.md | 7 ++++--- .../version-3/chart_template_guide/yaml_techniques.md | 7 ++++--- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/chart_template_guide/yaml_techniques.md b/docs/chart_template_guide/yaml_techniques.md index 436ad51eee..8235dc1a61 100644 --- a/docs/chart_template_guide/yaml_techniques.md +++ b/docs/chart_template_guide/yaml_techniques.md @@ -355,7 +355,8 @@ Because Helm and Kubernetes often read, modify, and then rewrite YAML files, the anchors will be lost. :::info -Reaching for anchors as a DRY mechanism? For sharing snippets across charts, -prefer [library charts](/topics/library_charts.md) — they are designed for -reuse and aren't affected by the round-trip pitfall described above. +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 436ad51eee..8235dc1a61 100644 --- a/versioned_docs/version-3/chart_template_guide/yaml_techniques.md +++ b/versioned_docs/version-3/chart_template_guide/yaml_techniques.md @@ -355,7 +355,8 @@ Because Helm and Kubernetes often read, modify, and then rewrite YAML files, the anchors will be lost. :::info -Reaching for anchors as a DRY mechanism? For sharing snippets across charts, -prefer [library charts](/topics/library_charts.md) — they are designed for -reuse and aren't affected by the round-trip pitfall described above. +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. :::